SYSIDCIN data sets in REORG PLUS

SYSIDCIN is the input data set that contains your IDCAMS command statements.

REORG PLUS uses these statements to delete and redefine user-defined (VCAT-defined) data sets or the staging data sets for your VCAT-defined data sets. REORG PLUS issues the commands that the SYSIDCIN data set contains. You are responsible for command specifications and results.

REORG PLUS requires the SYSIDCIN data set if the value of the REDEFINE option is YES and one of the following conditions exists:

• You want to delete and redefine your existing VCAT-defined VSAM data sets as part of the reorganization for SHRLEVEL NONE (the default) or SHRLEVEL REFERENCE UNLOADONLY.
• You want to delete and define the staging data sets for your VCAT-defined VSAM data sets as part of the reorganization for SHRLEVEL REFERENCE or SHRLEVEL CHANGE.

If you omit the SYSIDCIN data set and specify REDEFINE YES, REORG PLUS performs the following actions, depending on the value of the PREFORMAT command or installation option:

• If PREFORMAT=NO, REORG PLUS changes the value of REDEFINE to NO and continues with the reorganization (without deleting and defining the data sets).
• If PREFORMAT=YES, REORG PLUS terminates the reorganization and issues message BMC50391E.

The UTILINIT phase reads, parses, and performs minimal verification checks on the commands in this data set. REORG PLUS issues the commands for each object during reload processing.

You still have the option of deleting and redefining VCAT-defined data sets when you specify UNLOAD PAUSE on the command. However, when you specify UNLOAD CONTINUE or UNLOAD RELOAD, the only way to delete and redefine VCAT-defined data sets as part of the reorganization is to also specify REDEFINE YES and provide the SYSIDCIN data set that contains the necessary IDCAMS command statements.

SYSIDCIN can be either a single or concatenated list of sequential data sets, partitioned data set members, or both. The data set must be specified as fixed length with blocked records (RECFM=FB), and the record length must be 80 bytes (LRECL=80). Only columns 1 through 72 are used.

For important restart information, see Recovering-from-a-failure.  

Guidelines for providing IDCAMS commands in the SYSIDCIN data set

REORG PLUS supports the following IDCAMS commands and their associated parameters as defined in the IBM DFSMS Access Method Services for Catalogs document:

• DELETE
• DEFINE
• SET
• IF-THEN-ELSE command sequence
• DO/END (with restrictions)

REORG PLUS does not allow the following IDCAMS command specifications:

• An IF statement without a DEFINE, DELETE, or SET command
• A nested IF statement
• Different data set names specified in an IF statement
• More than one DO/END statement within a single THEN or ELSE clause
• A DO/END statement outside of an IF statement
• An embedded comment (a comment within a comment)
• A comment on a DO statement that continues to the next line
• A keyword that continues to the next line

REORG PLUS checks for these specifications during the UTILINIT phase and terminates with an error message if it finds any of them.

To avoid a failure during processing, ensure that each DEFINE has a corresponding DELETE specified before it, and that each DELETE has a corresponding DEFINE specified after it. Ensure that both commands specify the same data set name.

REORG PLUS terminates if IDCAMS returns a nonzero maximum condition code (MAXCC) value or encounters any syntax errors during command processing. You must correct the error and either restart or recover and then resubmit the job. If you do not want REORG PLUS to terminate in case of a failure during the RELOAD or REORG phase, use the SET command to reset the IDCAMS condition code. For more information about restarting during the RELOAD and REORG phases, see Restarting-REORG-PLUS. 

When you specify SHRLEVEL NONE (default) or SHRLEVEL REFERENCE UNLOADONLY

Using the Guidelines for providing IDCAMS commands in the SYSIDCIN data set, specify commands only for those VCAT-defined data sets that you want to delete and redefine. REORG PLUS reuses any data sets participating in the reorganization that have no corresponding IDCAMS commands. REORG PLUS ignores any command that references a data set that does not participate in the reorganization and issues message BMC50604I. REORG PLUS ignores any empty SYSIDCIN data set and continues processing. 

When you specify SHRLEVEL REFERENCE or SHRLEVEL CHANGE

Using the Guidelines for providing IDCAMS commands in the SYSIDCIN data set, specify commands that operate only on the staging data sets for your VCAT-defined VSAM data sets. Always use the naming conventions outlined in Staging-data-sets.

To define the staging data sets and avoid definition errors, provide a DELETE statement followed by a SET MAXCC=0 command (in case the delete process fails) before each DEFINE statement. REORG PLUS processes this set of statements (DELETE, SET MAXCC, DEFINE) for each object as the RELOAD phase begins for that object. REORG PLUS ignores any command that references one of the original VCAT-defined data sets and issues message BMC50604I.