Previous PageTable Of ContentsNext Page

    SAFECONV Utility


.

SAFECONV

--------

-

Fm Fp [USRDFLT ] [Ofp] [([INCLUDE fid] [OSFS] [RESTART -]]
------
[USRADMIN]-------[([EXCLUDE fid]--------[NORESTART]]

-----------------------------------------------------------

      Fm-------- Specifies an mdisk that the output
      -----------
      SafeSFS rule files will be written to.

      Fp------ - Specifies the input SFS FILEPOOL and
      --- -------
      must-be specified without a trailing
      -----------
      colon (:).

      USRDFLT -- Rule file type for the SafeSFS
      USRADMIN
      - rules that are generated.

      Ofp----- - SFS FILEPOOL name to be used in the
      -----------
      SafeSFS rules generated.

( OPTIONS:

      INCLUDE Fid - Limits the conversion to filespaces
      --------------
      listed in the CMS file, Fid.
      EXCLUDE Fid
      - Limits the conversion to filespaces

      --------------
      NOT listed in the CMS file, Fid.

      OSFS------- - Indicates that a file containing the
      --------------
      existing SFS authorizations should be
      --------------
      created.

      RESTART---- - Causes SAFECONV to start processing
      --------------
      at the filespace it was previously
      --------------
      processing, prior to being terminated
      --------------
      abnormally.
      NORESTART
      --- Causes SAFECONV to start processing
      --------------
      from the beginning, even if SAFECONV
      --------------
      had been previously terminated
      --------------
      abnormally.

--


Purpose

Use the SAFECONV Utility to convert existing SFS object authorizations to SafeSFS rules. Since SFS uses a very simple authorization structure, SAFECONV is unable to take full advantage of the power and flexibility of SafeSFS rules. SAFECONV will optimize the rules it generates when possible, but will always generate rules that behave identically to the SFS authorizations that were converted. Further optimization may be performed manually, but cannot be automated and still have it preserve identical behavior in all cases.

Authorization

The user executing this utility must have access to the SAFECONV EXEC on the SafeSFS 192 mdisk, and must also be an SFS Administrator for the input filepool Fp.

Parameters

Fm:

Specifies the file mode of an accessed R/W mdisk that the SafeSFS rule files, that are generated by SAFECONV, will be written to. If a rule file exists on the mdisk, SAFECONV will append any rules that are generated for the file to the end file. This parameter is required.

Fp:

Specifies the name of the input filepool. The SFS object authorizations contained in the input filepool are converted to SafeSFS rules. This parameter is required.

USRDFLT :
USRADMIN :

This parameter specifies the rule file type that is used when creating rule files containing the new SafeSFS rules. USRDFLT is the default if a rule file type is not specified.

Ofp:

Specifies the name of the filepool to be used on all SafeSFS rules generated by SAFECONV. If this parameter is omitted, the default is the input filepool name (Fp). Trailing pattern matching may be used for this parameter. Specify an asterisk "*" to indicate all file pools.

Options:

    INCLUDE Fid

Specifies a CMS file that contains a list of filespace names, one per record beginning in column one. SAFECONV will generate SafeSFS rules ONLY for the filespaces listed. The INCLUDE option may not be used with the EXCLUDE option. By default, SAFECONV will generate SafeSFS rules for all filespaces.

   

    EXCLUDE Fid

Specifies a CMS file that contains a list of filespace names, one per record beginning in column one. SAFECONV will NOT generate SafeSFS rules for the filespaces listed. SafeSFS will generate rules for all other filespaces. The EXCLUDE option may not be used with the INCLUDE option. By default, SAFECONV will generate SafeSFS rules for all filespaces.

   

    OSFS

Causes SAFECONV to produce the Fp OSFSAUTH A file containing a list of the original SFS authorizations. If this option is omitted, SAFECONV will not produce the OSFSAUTH file.

   

    RESTART

Causes SAFECONV to resume processing at the beginning of the filespace it was processing prior to being terminated abnormally. If omitted, RESTART is the default.

   

    NORESTART

Causes SAFECONV to process all filespaces specified, even if SAFECONV had been previously terminated abnormally.


Return Codes

Return Code

Meaning

0

Completed successfully.

8

Abnormal termination.


Usage Notes

  1. SAFECONV creates a temporary file called SAFECONV RESTART A. The file contains the last filespace completely processed. Filespaces are processed in alphabetical order. This file is erased when SAFECONV completes successfully.


  2. SAFECONV should not be restarted after modifying the INCLUDE or EXCLUDE file. This may cause SAFECONV to omit SFS authorizations that should be converted. Specify NORESTART if the INCLUDE or EXCLUDE file has changed since SAFECONV was terminated abnormally.


  3. SAFECONV should not be restarted after modifying SFS authorizations. This may cause SAFECONV to omit SFS authorizations that should be converted. Specify NORESTART if SFS authorizations have changed since SAFECONV was terminated abnormally.


  4. SFS authorizations should not be updated while SAFECONV is running. This may cause SAFECONV to omit SFS authorizations that should be converted.


  5. SFS filespaces should not be deleted while SAFECONV is running. This may cause abnormal termination of SAFECONV.


Previous PageTable Of ContentsNext Page