PROCESS Parameter

The PROCESS parameter specifies the input required, and the output(s) to be created by this execution of CA IDMS Journal Analyzer. It also indicates whether processing is to be discontinued if a parameter error is detected. A single valid PROCESS parameter is required as the first request in the Parameter file.

The PROCESS parameter syntax is as follows.

             / ALL       \    ┌          / Y \  ┐
 PROCESS =   < REPORTS   >    │ ,CONT =         │
             │ DISPLAYS  │    └          \ N /  ┘
             \ EXTRACTS  /

 ┌            / FULL    \  ┐
 │ ,FORMAT =               │
 └            \ SPARSE  /  ┘

 ┌               / Y \  ┐     ┌               / Y \  ┐
 │ ,RHDCRUAL =          │     │ ,IDMSXXXX =          │
 └               \ N /  ┘     └               \ N /  ┘

 ┌              / Y \  ┐
 │ ,NONUNIQ =          │    ┌ ,USERDCOM = procedure name ┐
 └              \ N /  ┘    └                            ┘

 ┌            / Y \  ┐
 │ ,ABEND =          │
 └            \ N /  ┘
 │ ,UTC              │

 where:

            / ALL       \
 PROCESS =  < REPORTS   >
            │ DISPLAYS  │
            \ EXTRACTS  /

Identifies the type of processing to be performed by CA IDMS Journal Analyzer. You can use one of four options to define the type of processing:

ALL - This option directs CA IDMS Journal Analyzer to create an Extract file and any Journal Reports and Journal Displays requested by appropriate parameters.

REPORTS - This option indicates that an Extract file is to be input and that only Journal Reports are to be produced.

Note: An Extract file must be input to CA IDMS Journal Analyzer when the REPORTS option is specified.

DISPLAYS - this option indicates that an Archive Journal is input and that journal displays are to be created. No Extract file creation is performed, and no reports are produced.

EXTRACTS - This option indicates that only an Extract file is to be created (no journal displays, and no reports are produced). Input is one or more Archive Journal files.

┌           / Y \    ┐
│   ,CONT =          │
└           \ N /    ┘

Indicates whether processing should continue if parameter errors are detected.

Y - Indicates that processing is to continue.

N - Indicates that processing is to terminate. This option is the default value.

Note: Blanks are not a valid option for this parameter.

┌              / FULL   \    ┐
│    ,FORMAT = <        >    │
└              \ SPARSE /    ┘

Designates the format of the journal displays.

FULL - Indicates that all record positions are to be displayed with the changed values highlighted.

Note: No highlighting occurs for SUBSCHEMA DISPLAYS.

SPARSE - indicates that only the changed values are to be displayed. This option is the default value.

┌                 / Y  \    ┐
│   ,RHDCRUAL  =            │
└                 \ N  /    ┘

Allows extract and display records to be produced for run units whose program name is Y - causes the extract and display records to be produced.

N - Indicates that the extract and display records are not required. This option is the default value.

Note: Blanks are not a valid option for this parameter.

┌                / Y  \    ┐
│   ,IDMSSXXXX =           │
└                \ N  /    ┘

Allows extract and display records to be produced for run units whose program name begins with IDMS.

Y - Causes the extract and display records to be produced.

N - Indicates that the extract and display records are not required. This option is the default value.

Note: Blanks are not a valid option for this parameter.

┌              / Y  \   ┐
│   ,NONUNIQ =          │
└              \ N  /   ┘

Specifies the action to be taken when a record id is not uniquely defined in the data dictionary (is described in multiple schemas).

Y - Causes only the first description for the record id to be processed.

N - Causes only the first description for the record id to be processed, prevents the record from being decompressed if it is compressed, and causes an error message (***NON-UNIQUE RECORD TYPE***) to replace the record name if multiple record descriptions are encountered for a record id. This option is the default value.

Note: Blanks are not a valid option for this parameter.

 [ ,USERDCOM = procedure name ]

Designates the database procedure name of a user-written decompression routine for Journal Displays. This routine, substitutes for the CA IDMS supplied module IDMSDCOM, and must not issue any CA IDMS Central Version macros such as #GETSTG and #FREESTG. If IDMSDCOM is replaced with a user version of the same name, then USERDCOM = IDMSDCOM must be entered. If the compressed version of the database record is to be retained for displays, then a 'dummy' procedure name must be specified (e.g., USERDCOM = NONE).

Note: If your decompression routine requires that the valid subschema name be placed in the Applications Control Block, then the programs must be registered to their subschemas.

┌           / Y  \   ┐
│   ABEND =          │
└           \ N  /   ┘

Specifies that upon certain processing errors CA IDMS Journal Analyzer will either produce an operation exception abend, or that it will terminate with a return code of 16.

Y - causes termination with an operation exception.

N - causes termination with a return code of 16. This option is the default value.

Note: Blanks are not a valid option for this parameter.

| UTC |

Specifies that the journal record times on all reports and displays are shown in UTC time. By default all journal record times are shown in local time.