Changing system libraries

After using SMP/E to install z/OS, change the system libraries using the following procedures.

2 Update PARMLIB.

2a Update IGDSMSxx PARMLIB member.

Update the IGDSMSxx PARMLIB member to include the following OAM-related keywords:

OAMPROC(procname): Optional parameter that specifies the procedure name to be used to start the OAM address space. Specify this keyword to start the OAM address space automatically during IPL. The procedure name can be from 1 to 8 characters, and there is no default.
OAMTASK(taskid): Optional parameter that specifies the identifier to be used to start the OAM address space. If you specify this keyword without the OAMPROC keyword, it is ignored. This identifier can be from 1 to 8 characters, and there is no default. Code the OAMTASK keyword if you prefer to use an identifier other than the procname when starting the OAM address space. taskid is the identifier that is used on the START command. taskid corresponds to the ‘identifier’ parameter of the MVS START command documented in z/OS MVS System Commands.

These optional parameters are used when you want the OAM address space to start automatically as part of SMS initialization. "OAM" can be used as the procedure name, the task identifier, or both.

Note: For examples of the OAM START command and more information concerning the identifier parameter, see Starting OAM. For more information on the START command, see z/OS MVS System Commands. Also, for more details concerning these optional parameters and other keywords associated with the IGDSMSxx PARMLIB member, see z/OS DFSMSdfp Storage Administration.

2b Update IEFSSNxx PARMLIB member.

Add or update the OAM1 entry in the IEFSSNxx PARMLIB member.

SUBSYS SUBNAME(OAM1) INITRTN(CBRINIT) INITPARM('[TIME=GMT][,MSG=xx]')

where:

TIME=GMT: Specifies that OAM uses Greenwich Mean Time. If this option is omitted, or if any value other than GMT is specified, local time is used. For tape library volumes, this time specification affects the date set in the tape configuration data base (TCDB) volume record when a volume is entered/imported into or ejected/exported from a tape library.
MSG=xx: Specifies the format of OAM message text:

MSG=EM specifies message text is in mixed-case English.
MSG=EU specifies message text is in uppercase English.
If the MSG parameter is omitted, the default is mixed-case English.

OAM1 is the name of the subsystem, and CBRINIT is the name of the initialization module executed at IPL time.

Rule: The SMS subsystem must be started before the OAM1 subsystem is started, therefore ensure that the SMS entry precedes the BEGINPARALLEL keyword in the IEFSSNxx parmlib member. The OAM1 subsystem entry in IEFSSNxx can then follow the BEGINPARALLEL keyword. If the BEGINPARALLEL keyword is not being used, you must still ensure that the SMS subsystem entry precedes the OAM1 subsystem entry. The OAM1 entry defines the OAM1 subsystem. To prevent a possible system abend, ensure that the subsystem name in the IEFSSNxx member is different from the name of the PROCLIB member used to start OAM.

Note: You can add the OAM subsystem without re-IPLing the system by using the SETSSI ADD,S=OAM1,I=CBRINIT command. After the OAM subsystem is started, OAM will ignore any further updates made by subsequent SETSSI commands. See z/OS MVS System Commands for information on using the SETSSI command.

2c Update CONSOLxx PARMLIB member.

To define a library console to MVS that allows console name message routing, perform the following steps:

Update PARMLIB member PARMLIB(CONSOLxx).
- Add console definitions for each library in your SCDS; an example follows:
```
CONSOLE DEVNUM(device number)
        NAME(library console name)
        UNIT(terminal type)
        AUTH(SYS,IO)
        (...)
```
- The library console name matches the console name defined in your SCDS using the ISMF library definition panel.
  The authorities (SYS and IO) are suggested in order to perform the modify commands for OAM and the VARY commands for MVS.

See z/OS MVS System Commands and z/OS MVS Planning: Operations for further information regarding multiple console support (MCS) definitions.

2d Update DEVSUPxx PARMLIB member.

Normally, when a scratch volume recorded in higher-level recording format is mounted on a drive that that supports the media type but not the higher-level recording format, the operating system rejects the mounted volume and asks for another volume to be mounted. This is because the data set labels on the volume cannot be read and validated. If you want the volume to be used, create a DEVSUPxx member of PARMLIB and specify VOLNSNS=YES.

If you are partitioning an ATLDS, use the DEVSUPxx library partitioning-related parameters to change the system default category assignments. See z/OS MVS Initialization and Tuning Reference for more information regarding DEVSUPxx.

To take advantage of nonspecific (scratch) mount performance in a Virtual Tape Server (VTS) or a Peer-to-Peer VTS, remember to set the Fast Ready attribute at the library manager for the scratch categories to be used. This includes the system default scratch categories and any user-defined scratch categories to be used for partitioning the library.

For the capability to share MTL devices as stand-alone, see Manual tape library considerations for potential usage of the MTLSHARE keyword.

2e Create or update CBROAMxx PARMLIB member (optional; used with the SETTLIB command)

You must perform this step if you intend to use the SETTLIB (set tape library) command statement in the CBROAMxx PARMLIB member to tune your tape library environment. Previously this PARMLIB member had only been used with OAM's object support.

This CBROAMxx member is invoked using the OAM=xx parameter in the OAM member of PROCLIB and is processed during OAM address space initialization. You must create or update the CBROAMxx member to use the optional SETTLIB support. The CBROAMxx member may already be used with OAM's object support. If so, SETTLIB is an additional command statement that can be used for tape library processing. If you do not specify specific parameters, the defaults are used. You can include the CBROAMxx PARMLIB member in any data set that is specified in the concatenation list in SYS1.IPLPARM(LOADxx).

For information about using the SETTLIB command in the CBROAMxx PARMLIB member, see SETTLIB statement for tape library settings and ONLYIF statements in a PLEX.

SETTLIB statement for tape library settings

The SETTLIB statement and its associated keywords of the CBROAMxx PARMLIB member can be used to override the default behavior for some of the main cartridge entry messages in a system managed tape library environment. The SETTLIB command statement and keywords are processed when the OAM address space is started and cannot be updated by operator command.

The syntax for the SETTLIB statement follows.


SETTLIB statement syntax

>>-SETTLIB--+------------------------------+-------------------->
            '-ENTRYIGNOREMSGTYPE(msg_mode)-'   

>--+-------------------------------------+---------------------->
   '-ENTRYIGNOREMSGDEST(msg_destination)-'   

>--+--------------------------------------+--------------------><
   '-ENTRYSUCCESSMSGDEST(msg_destination)-'

SETTLIB statement keywords: The keywords for the SETTLIB statement are:

ENTRYIGNOREMSGTYPE(msg_mode)

An optional parameter that specifies how OAM will display volume entry ignore messages during cartridge entry processing. If this parameter is omitted, the default behavior is “DETAIL”.

DETAIL

Volume ignore messages will have default behavior. The following messages will be displayed for each volume ignored during cartridge entry processing:

CBR3620I Entry of volume volser into library library-name failed. 
CBR3621I Enter request ignored by the cartridge entry installation exit (CBRUXENT).

SUMMARY

Volume ignore messages will be displayed in a summary format, up to 48 volumes at a time, 8 volumes per line (6 lines maximum):

CBR3670I Volume entry processing. Enter requests ignored for the following volumes in library library-name. 
volser1 volser2 volser3 volser4 volser5 volser6 volser7 volser8

SUPPRESS

A single status line will be displayed for all volumes ignored during cartridge entry processing:

 CBR3672I Enter requests ignored for one or more volumes in library library-name. The first volume ignored was volser.

ENTRYIGNOREMSGDEST(msg_destination)

An optional parameter that specifies where OAM will display volume entry ignore messages during cartridge entry processing. If this parameter is omitted, the default behavior is “ALL”.

ALL: Volume entry ignore messages will be displayed on both the console and system log.
SYSLOG: Volume entry ignore messages will be displayed only in the system log.

ENTRYSUCCESSMSGDEST(msg_destination)

An optional parameter that specifies where OAM will display successful volume entry messages (CBR3610I) during cartridge entry processing. CBR3610I is displayed in a format similar to the CBR3670I message and only has the SUMMARY message mode. There is no separate ENTRYSUCCESSMSGTYPE option. If this parameter is omitted, the default behavior is “ALL”.

ALL: Successful volume entry messages will be displayed on both the console and system log.
SYSLOG: Successful volume entry messages will be displayed only in the system log.

ONLYIF statements in a PLEX

The ONLYIF statement can be used to specify whether or not specific statements within the CBROAMxx PARMLIB member are to be processed on a given system. The scope of the ONLYIF statement is in effect until the next ONLYIF is encountered.

The syntax for the ONLYIF statement follows.


ONLYIF statement syntax

>>-+---------------------------------------+-------------------><
   '-ONLYIF-+----------------------------+-'   
            |          .-*ALL*-------.   |     
            '-SYSNAME(-+-system_name-+-)-'

ONLYIF

You can use the ONLYIF statement to specify whether or not specific statements within the CBROAMxx PARMLIB member are to be processed on a given system. The scope of the ONLYIF statement is in effect until the next ONLYIF is encountered.

Note: The ONLYIF statement and each of the SETTLIB statements that follow it must be on separate lines.

SYSNAME: Specifies the system name on which the set of SETTLIB statements which follow are to be processed. Valid values are a 1-8 character system name or the reserved string *ALL*. If a system_name is specified, then the following statements are processed only if the system OAM is initializing on has a matching system name. The system name is defined by the SYSNAME parameter in the IEASYMxx or IEASYSxx PARMLIB members. If *ALL* is specified, the statements are processed on all systems. If the SYSNAME keyword is not specified, the default value is *ALL*.

In this example, SETTLIB ENTRYIGNOREMSGTYPE(SUMMARY) is processed only if the system is SYS1 and all of the statements after ONLYIF SYSNAME(*ALL*) are processed on all systems.

ONLYIF SYSNAME(SYS1)
SETTLIB ENTRYIGNOREMSGTYPE(SUMMARY)
ONLYIF SYSNAME(*ALL*)
SETTLIB ENTRYIGNOREMSGDEST(SYSLOG)

Note: The value of an ONLYIF statement cannot be displayed with the F OAM,DISPLAY command or updated with the F OAM,UPDATE command.