The installation can optionally create one or more
IXGCNFxx members and place them in SYS1.PARMLIB. The following methods
can be used to specify the current IXGCNFxx members:
- The operator can enter the SET IXGCNF=xx command at any time after IPL.
- You can specify the IXGCNF=xx parameter in the IEASYSxx parmlib member during IPL, and then select IEASYSxx in the LOADxx parmlib member or specify SYSP=xx in response to the SPECIFY SYSTEM PARAMETERS system message.
- You can specify IXGCNF=xx in response to the SPECIFY SYSTEM PARAMETERS system message.
You can specify one or more current IXGCNFxx parmlib members during IPL. For example, a IXGCNF=(00,01) system parameter informs the system to use IXGCNF00 and IXGCNF01 as current members. The system processes these members in the order they are specified. For all options, the last parmlib member specifying the option is honored.
If any errors are encountered for the specified
IXGCNFxx parmlib members, logger will issue an error message and then
attempt to process remaining parameters for syntax. For a SET IXGCNF
command, parameter updates are not done. At IPL, default values
are substituted for all parameters. For example, assume a shared
IXGCNFxx parmlib includes the MONITOR LSPRIMARY,CONSUMPTIONALERT(value)
specification. Also assume one release is at z/OS® V1R13 and the other is at z/OS V2R1, The shared IXGCNFxx parmlib member
will be honored on the z/OS V2R1
release. However, the z/OS V1R13
release processing will issue an unrecognized keyword type error message,
and use the system defaults for all the IXGCNFxx options.
As part of the IXGCNF parmlib processing, logger might issue a TRACE CT or a DISPLAY LOGGER command. For information about required SAF authority, see the topic on defining authorization for the system logger address space in z/OS MVS Setting Up a Sysplex.
Before changing options with SET IXGCNF=xx, consider issuing a D LOGGER,IXGCNF command to see what options are currently in affect. Combine the displayed options with any new request that shares the same option statement. Note, the SETLOGR system command can also be used to make changes to the system logger (IXGLOGR) address space processing, and can be used to dynamically change some of the options provided in parmlib.
The following restrictions apply to the IXGCNFxx parmlib parameters when attempted to be updated as part of the SET IXGCNF=xx command processing.
- ZAI SERVER and PORT changes are not honored if there are existing socket connections to the IBM zAware server. Disconnect the applicable log streams or quiesce any existing socket connection through the SETLOGR FORCE,ZAIQUIESCE command (use the ALL keyword or LSN= for each applicable log stream).
- Reducing the LOGBUFMAX value below the current in-use storage buffers will cause system logger to put the LOGBUFFULL specification into effect.