Version 4.2.6 for Mainframes
 —  Utilities  —

Special Commands Issued to SYSMAIN

There are commands that can be issued to the SYSMAIN utility to perform functions related to the operation of the utility itself or to define the security for Natural system files.

Command Function

ADAON
or
NOADA
or
ADAOFF

Activate (ADAON) or deactivate (NOADA or ADAOFF) error trapping.

Trap abnormal database errors (only applicable online with programming objects) for debugging purposes.

BATCH
or
NOBATCH

Switch the SYSMAIN utility into batch mode (BATCH), whereby all processing is done as if SYSMAIN was running in batch. If online automated processing is used, a batch report is then displayed: see also Online Report Mode.

NOBATCH switches the SYSMAIN utility back to online mode.

CLEAR Clear the current work area. This function can be useful if the source code of a large object is contained in the work area and the SYSMAIN utility therefore requires a larger ESIZE.
DISPLAY Display the extended (long) message text for the error which has occurred.
FINDFIRST Stop the FIND command for programming objects when the first library is found that contains the specified object.
FINDALL Cause the FIND command for programming objects to search in all libraries.

MON
or
NOMON
or
MONOFF

Activate (MON) or deactivate (NOMON or MONOFF) tracing of the current activity in SYSMAIN. See also MON in Keywords and Variables in Direct Commands.

PROMPT
or
NOPROMPT

Enable (PROMPT) or disable (NOPROMPT) the SYSMAIN prompts. See also PROMPT in Keywords and Variables in Direct Commands.
SET Invoke the Command Help window where all special SYSMAIN commands are explained.
SET FDIC Invoke a window to specify Adabas security information for the Predict system file. This refers to the profile parameter FDIC (see FDIC - Predict System File in the Parameter Reference documentation). In batch mode, you can specify security information by using the keyword DIC in a where-clause as indicated in the direct command syntax in the object-type specific sections of the SYSMAIN Utility documentation.

See also Special Considerations for Administrators.

SET FNAT Invoke a window to specify Adabas security information for the SYSMAIN source and target system files. In batch mode, you can specify security information by using the keyword SEC in a where-clause as indicated in the direct command syntax in the object-type specific sections of the SYSMAIN Utility documentation.

See also Special Considerations for Administrators.

SET FSEC Invoke a window to specify Adabas security information of the FSEC system file if Natural Security is installed. This refers to the profile parameter FSEC (see FSEC - Natural Security System File in the Parameter Reference documentation).

See also Special Considerations for Administrators.

SET PC Only applies if Natural Connection and Entire Connection are installed.

Activate the PC connection. This setting can be intermittently changed with the %+ and %- terminal commands (see also Enable/Disable Use of Natural Connection in the Terminal Commands documentation). SET PC then results in SYSMAIN re-verifying the status of the PC connection.

STATUS Display the current values of SYSMAIN variables that are important for Software AG technical support.
TOTAL
Invoke the Results of Function window which verifies the processing of the last SYSMAIN function executed. The following information is displayed for saved (source) and cataloged objects:
   
Read Total number of objects which were actually read, based on the object name specification.
Rejected Total number of objects read which were then rejected, based on the selection criteria specified. See also Object Rejection and Reasons.
Processed Total number of objects which were processed.
Added Total number of new objects added to the target environment.
Updated Total number of existing objects updated. (Where possible, SYSMAIN attempts to update existing objects instead of deleting and adding new ones.)
Deleted Total number of objects deleted from either the source or target environment, depending on the function and the setting of the replace option.
Replaced Total number of objects which were replaced in the target environment.
Not Repl. Total number of objects which were not replaced in the target environment.
Recs.Read: Total number of records which were read.
.

or

END

or

QUIT
Terminate SYSMAIN.

Top of page