ONLYIF statements in an OAMplex

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.

Read syntax diagramSkip visual syntax diagram
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 OAMXCF, SETOAM, SETOPT, and SETOSMC statements that follow it must be on separate lines.
SYSNAME
Specifies the system name on which the set of OAMXCF, SETOAM, SETOPT, and SETOSMC statements which follow are to processed.Valid values are 1-8 character system name or the reserved string *ALL*. If a system_name is specified, then the following statements are only processed 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 the following example, OAMXCF OAMMEMBERNAME(OAM1) is processed only if the system is SYS1, OAMXCF OAMMEMBERNAME(OAM2) is processed only if the system is SYS2, and all of the statements after ONLYIF SYSNAME(*ALL*) are processed on all systems.
ONLYIF SYSNAME(SYS1)
OAMXCF OAMMEMBERNAME(OAM1)

ONLYIF SYSNAME(SYS2)
OAMXCF OAMMEMBERNAME(OAM2)

ONLYIF SYSNAME(*ALL*)
OAMXCF OAMGROUPNAME(OPLEX01)

SETOAM PERCENTVALID (99) MAXRECYCLETASKS(3)
			MAXTAPESTORETASKS(1) MAXTAPERETRIEVETASKS(1)
			TAPEDISPATCHERDELAY(3)
			DSNWITHSGNAME
			TAPEEXPIRATION(2009/364)
			MOUNTWAITTIME(1)
			DEMOUNTWAITTIME(3)
			TAPEFULLTHRESHOLD(9999)
			TAPERECYCLEMODE(OAMSCRATCH)
			DATACLASS(VTSM2CU)

	STORAGEGROUP(GROUP01 TAPEUNITNAME(3490) L2TAPEUNITNAME(3490)
		L2DATACLASS(VTSM2CU)
		NOTAPECOMPACTION SGMAXTAPESTORETASKS(1)
		SGMAXTAPERETRIEVETASKS(1))

	STORAGEGROUP(GROUP01 TAPEUNITNAME(3490) L2DATACLASS(VTSM2CU)
		L2TAPEUNITNAME(3490)
		NOTAPECOMPACTION SGMAXTAPESTORETASKS(1)
		SGMAXTAPERETRIEVETASKS(1))
Note: The value of an ONLYIF statement cannot be displayed with the F OAM,DISPLAY command or updated with the F OAM,UPDATE command.