Privileges: | SUBSYSTEM-MANAGEMENT, STD-PROCESSING |
Function
The MODIFY-IMON-OPTIONS statement defines defines the following defaults for the current IMON programme run:
the SCI to be processed (SCI-NAME operand)
the location at which work files and software that need to be parked are temporarily stored (WORK-FILE-LOCATION operand)
a reference file, which is to be used as the basis for a configuration check during installation (operand REFERENCE-FILE)
After IMON is called, the respective default values are valid immediately (corresponds to the respective operand value *STD). The currently set values are valid until a new value is explicitly set (with MODIFY-IMON-OPTIONS or the relevant menu function) or until the end of the IMON programme run.
Format
MODIFY-IMON-OPTIONS |
SCI-NAME = *UNCHANGED / *STD / <filename 1..50 without-gen-vers> ,WORK-FILE-LOCATION = *UNCHANGED / *STD / <partial-filename 2..23> ,REFERENCE-FILE = *UNCHANGED / *STD / <filename 1..54 without-gen-vers> |
Operands
SCI-NAME =
Selects an SCI. This SCI is retained until the MODIFY-IMON-OPTIONS statement is used to select a different SCI or IMON is ended. Both these actions implicitly close the SCI. Privileged users can use this operand to open a foreign SCI. If the foreign SCI defined here does not yet exist, it is generated under the specified file name on another pubset.
You have write access to the SCI when it is opened if you are a privileged user, whereas the SCI is read-only for nonprivileged users.
SCI-NAME = *UNCHANGED
The open SCI is left alone. If no SCI was opened beforehand, the standard SCI is opened.
SCI-NAME = *STD
The standard SCI $TSOS.SYS.IMON.SCI is opened on the home pubset.
SCI-NAME = <filename 1..50 without-gen-vers>
Explicit specification of an SCI. The file name is restricted to a maximum of 50 characters, because 4 characters are reserved for the ”.GPN” suffix.
WORK-FILE-LOCATION =
Specifies the location where the software is to be parked or where work files are to be created.
If the user ID SYSSAG is defined, then it is set by default to the home pubset after the call using the START-IMON command. If it is not defined, then the location is set to $TSOS.IMON.
WORK-FILE-LOCATION = *UNCHANGED
The location selected in the preceding MODIFY-IMON-OPTIONS statement is retained.
WORK-FILE-LOCATION = *STD
The default location for work files to be used is the standard default one.
WORK-FILE-LOCATION = <partial-filename 2..23>
Explicit specification of the location. Temporary files may not be specified.
The specification is made in the form <partial-filename 2..23> and can contain a file name prefix in addition to a catalog ID and user ID. The file name prefix may be up to a maximum of 7 characters long (including the period at the end).
The specification of a prefix can lead to problems in the following statements when the name created exceeds the maximum file name length permitted. For this reason it is recommended not to exceed a total length of 18 characters (including catalog ID and user ID) when a prefix is used.
REFERENCE-FILE =
Selects a reference file which is to be used as the basis for a configuration check during installations. The selection is valid until a new reference file is specified with MODIFY-IMON-OPTIONS or IMON is ended.
REFERENCE-FILE = *UNCHANGED
The previously agreed reference file is kept. If no reference file had been specified, the default reference file is still valid (see *STD).
REFERENCE-FILE = *STD
The default reference file, $TSOS.SYS.IMON.SCI.REF, is used on the home pubset.
REFERENCE-FILE = <filename 1..54 without-gen-vers>
Location of a reference file.
Notes
The statement is rejected and an error message is displayed in the following cases:
If one of the following errors occurred when the operand SCI-NAME was entered:
The file name that was specified without a catalog ID and/or a user ID cannot be extended to produce a path name of up to 50 characters.
The SCI was not cataloged using USER-ACCESS=WRITE.
The user has the SUBSYSTEM-MANAGEMENT privilege, but the specified SCI cannot be generated, and read and write access is not permitted for it.
The user has the STD-PROCESSING privilege, but the specified SCI cannot be generated, and read access is not permitted for it.
The user ID and/or catalog ID specified in the WORK-FILE-LOCATION operand is not defined in the system or cannot be accessed.
The file name prefix specified in the WORK-FILE-LOCATION operand is longer than 7 characters (including the dot at the end).