CA-GSS/ISERV Commands › CA-GSS Initialization Parameters › ISET

ISET

This parameter defines an ISET for loading or reloading IMODs.

Syntax

ISET name [DSN dsname] [loadoption|accessoption] [DESC /desc/]

[SSID ssid]

Parameters

name

1- to 16-character name for the ISET. If the ISET is to be available for reloading (from TSO), this ISET name must match the ISET name as defined to the TSO user. Throughout an installation, each ISET name should point to the same data set, although each data set can be referred to by multiple ISET names.

dsname

Name of a VSAM KSDS that contains the ISET. When a reload request for an IMOD is processed by CA‑GSS, ISET name and dsname, as defined to both CA‑GSS and the requestor, must be an exact match.

loadoption

Indicates whether an IMOD should be loaded. Specify one of these options:

FORCE

Loads an IMOD and, if another IMOD is currently loaded, replaces it with the new IMOD.

LOAD

Loads an IMOD; however, does not replace any currently loaded IMOD.

NOFORCE

Negates a FORCE specification.

NOLOAD

Negates a LOAD specification.

accessoption

Default access level for the ISET when accessed from the IMOD editor. Specify READ (read-only) or WRITE (read/write).

desc

1- to 52-character description of the ISET's contents. The IMOD editor displays this description.

Because a description can contain blanks, the first non-blank character that follows the DESC parameter is assumed to be the delimiting character.

ssid

Default subsystem ID that the IMOD editor should use for dynamic IMOD loading and execution.

Usage Notes

• Only valid IMODs can be loaded into CA‑GSS. A valid IMOD (for an ISERVE address space) is one that compiled without errors and is in production or force status. In batch mode, a valid IMOD is one that compiled without errors and is in test, production, or force status.
• If loading of the IMOD would cause a previously loaded IMOD of the same name to be replaced, the operation is suppressed for an IMOD in production status (or test status, if batch).
• To force the load of an IMOD from the internal (system) ISET, either code FORCE and force-load the entire ISET, or change the status of one or more IMODs to force.
• If neither LOAD or FORCE is coded, the ISET is merely defined and can be used later for dynamic IMOD loading.
• Define each ISET that is to be accessible to CA‑GSS, for loading or reloading IMODs, by an ISET statement. These statements are processed in the same order that they are encountered and can merely define an ISET or cause the contained IMODs to be loaded into CA‑GSS.
• The contents of the INTERNAL ISET, as shipped by CA Technologies, have been link-edited into the CA‑GSS load module. Hence, define this ISET only if there is a need to modify or reload an IMOD.
• If duplicate IMODs, the first occurrence is retained unless the FORCE attribute is specified for the IMOD.
• During loading an IMOD, if the compiler version does not match the current interpreter version, the IMOD is automatically re-compiled. This process affects only the execution copy, and the updated version is not written to the ISET. To reduce the start-up overhead, recompile all IMODs in an ISET under the current compiler version. The UPGRADE option of the SRVMAINT utility provides this capability.
• If duplicate ISET statements are encountered (same ISET name), the arguments are applied to the existing definition, by adding new information or overriding an option.
• The CA‑GSS address space does not use the READ, WRITE, DESC, and SSID parameters. These parameters are recorded and furnished to the ISPF-based IMOD editor during the execution of the LINK command from the editor.