z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Object Support
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Updating SETOAM values

z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Object Support
SC23-6866-00

Table 1 lists the valid UPDATE command keywords and their associated SETOAM keywords. If a SETOAM keyword is not on the list, it is not modifiable on the F OAM,UPDATE command.
Table 1. Valid SETOAM keywords on the UPDATE command
UPDATE keyword Associated SETOAM keyword Associated value Value range
DATACL DATACLASS Name  
DMWT DEMOUNTWAITTIME Seconds 1 - 9999
EXPDATE TAPEEXPIRATION YYYY/DDD  
L2DATACL L2DATACLASS Name  
L2TAPEUN L2TAPEUNITNAME Unit name  
MAXRECYC MAXRECYCLETASKS Number 0 - 15
MWT MOUNTWAITTIME Minutes 1 - 120
PERCENTV PERCENTVALID Percent 0 - 100
SGMAXREC SGMAXRECYCLETASKS Number 0 - 15
SGMAXTPR SGMAXTAPERETRIEVETASKS Number 1 - 100
SGMAXTPS SGMAXTAPESTORETASKS Number 1 - 100
TAPEDISP TAPEDISPATCHERDELAY Seconds 0 - 60
TAPEUNIT TAPEUNITNAME Unit name  
TCOMP TAPECOMPACTION / NOTAPECOMPACTION Y/N  
TDRVSTRT TAPEDRIVESTARTUP Megabytes 1 - 9999
TFULLPER TAPEPERCENTFULL Percent 1 - 100
TFULLTHR TAPEFULLTHRESHOLD Kilobytes 0 - 999999
TRECYC TAPERECYCLEMODE GROUP | OAMSCR | MVSSCR  

The following is an example of the syntax to update or set the number of recycle tasks that can be run concurrently:

F OAM,UPDATE,SETOAM,[ALL],MAXRECYC,max_recyc_tasks
  • MAXRECYC represents the MAXRECYCLETASKS keyword of the SETOAM statement in the CBROAMxx PARMLIB member.
  • max_recyc_tasks represents the maximum number of MOVEVOL tasks that can run concurrently as a result of a RECYCLE command. Valid values are 0 to 15.
  • If a value of 0 is specified while there is an active START RECYCLE command processing, the update command fails.
If the execution of this command is successful, the system issues the following message: 
CBR1074I Update successful for SETOAM parameter MAXRECYC, new 
value max_recyc_tasks, scope (ALL). The previous value was old_value.

The following example is the syntax to update or set the number of recycle tasks that can be run concurrently for a specific storage group, or to set the number of recycle tasks that can be run concurrently for all storage groups:

F OAM,UPDATE,SETOAM,[ALL|group-name],SGMAXREC,sgmax_recyc_tasks
  • SGMAXREC represents the SGMAXRECYCLETASKS keyword of the SETOAM statement in the CBROAMxx PARMLIB member.
  • sgmax_recyc_tasks represents the maximum number of MOVEVOL tasks for a specific storage group that can run concurrently as a result of a RECYCLE command. Valid values are 0 to 15. If the SGMAXRECYCLETASKS associated with a given storage group exceeds the MAXRECYCLETASKS specified at the global level, OAM processes onlyconcurrent MOVEVOL tasks for the storage group up to the MAXRECYCLETASKS value.
  • If a value of 0 is specified while there is an active START RECYCLE command processing, the update command fails.
If the execution of this command is successful, the system issues the following message: 
CBR1074I Update successful for SETOAM parameter SGMAXREC, new value sgmax_recyc_tasks, 
scope (ALL | group-name). The previous value was old_value..

The following example is the syntax to update or set the default percent valid threshold for RECYCLE: 

F OAM,UPDATE,SETOAM,ALL,PERCENTV,percent_valid
  • PERCENTV represents the PERCENTVALID keyword of the SETOAM statement in the CBROAMxx PARMLIB member
  • percent_valid represents the threshold of valid data on a full tape volser to be considered a candidate for recycle selection. Valid values are 0 to 100.
If the execution of this command is successful, the system issues the following message: 
CBR1074I Update successful for SETOAM parameter PERCENTV, new value
percent_valid, scope ALL. The previous value was previous_percent_valid.
The following example is the syntax to update the L2TAPEUNITNAME value: 
F OAM,UPDATE,SETOAM,scope,L2TAPEUN,unitname
  • L2TAPEUN represents the L2TAPEUNITNAME keyword of the SETOAM statement in the CBROAMxx PARMLIB member.
  • unitname represents the unitname to be used for scope.
If the execution of this command is successful, the system issues the following message: 
CBR1074I Update successful for SETOAM parameter L2TAPEUN, new value 
unitname, scope scope. The previous value was old-unitname.
The following example is the syntax to update the L2DATACLASS value: 
F OAM,UPDATE,SETOAM,scope,L2DATACL,dataclass
  • L2DATACL represents the L2DATACLASS keyword of the SETOAM statement in the CBROAMxx PARMLIB member.
  • dataclass represents the dataclass to be used for scope.
If the execution of this command is successful, the system issues the following message: 
CBR1074I Update successful for SETOAM parameter L2DATACL, new value 
dataclass, scope scope. The previous value was old-dataclass.

The following examples show some F OAM,UPDATE,SETOAM commands:

F OAM,UPDATE,SETOAM,GROUP22,TAPEUNIT,TAPEESO

Assuming TAPEESO is a valid tape esoteric name defined to the system, this command sets the TAPEUNITNAME setting for only GROUP22 to the tape esoteric, TAPEESO.

TAPEUNITNAME is the MVS unit name that OAM uses to initially allocate a scratch tape when an object is stored to this Object or Object Backup storage group and stored on a tape volume. If tape volumes already belong to the object or object backup storage group, they are used first before allocating a scratch volume. Even though a tape unit name is specified for the group, the ACS routines (for environment ALLOC) can override the TAPEUNITNAME specification by assigning the allocation to a Tape storage group, thereby, steering the allocation into an ATLDS or an MTL.

F OAM,UPDATE,SETOAM,ALL,TFULLPER,90,TFULLTHR,100

This command updates all global values and every storage group name in the active SMS configuration to a TAPEPERCENTFULL value of 90 and a TAPEFULLTHRESHOLD value of 100.

F OAM,UPDATE,SETOAM,GROUP22,MWT,2,DMWT,4,TFULLPER,95

This command updates the values for MOUNTWAITTIME, DEMOUNTWAITTIME, and TAPEPERCENTFULL for only the GROUP22 storage group.

F OAM,UPDATE,SETOAM,ALL,TRECYC,GROUP
This command updates the value for TAPERECYCLEMODE for expired object tape volumes in all Object and Object Backup storage groups. The expired tape volumes remain in their current storage group. When this command executes successfully, OAM issues the following message: 
CBR1074I Update successful for SETOAM parameter TRECYC, new value GROUP, 
scope ALL. The previous value was MVSSCR.
F OAM,UPDATE,SETOAM,ALL,TRECYC,MVSSCR
This command updates the value for TAPERECYCLEMODE for expired object tape volumes in all Object and Object Backup storage groups. The expired tape volumes are returned to the MVS scratch pool. When this command executes successfully, OAM issues the following message: 
CBR1074I Update successful for SETOAM parameter TRECYC, new value MVSSCR, 
scope ALL. The previous value was GROUP.

This command updates the value for TAPEDISPATCHERDELAY to 3 seconds for object tape volumes in all Object and Object Backup storage groups.

F OAM,UPDATE,SETOAM,ALL,TAPEDISP,3
This instructs OAM to wait 3 seconds before demounting a tape volume even if other work is available for this drive. When this command executes successfully, OAM issues the following message: 
CBR1074I Update successful for SETOAM parameter TAPEDISP, new value 3, 
scope ALL. The previous value was 0.
Parent topic: Using the UPDATE command to set SETOAM, SETOSMC, and SETOPT values

Go to the previous page Go to the next page

Notices | Terms of use | Support | Contact z/OS | zFavorites



Copyright IBM Corporation 1990, 2014