The RESYNCH command allows you to change the devices managed by CA MIA without the need to restart your system or CA MIA.
Scope: Local
This command has the following format:
RESYNCH [COMMANDS={DDNAME|NONE}]
[DEVCLASS={NONE|TAPE}]
[DEVLIST={DDNAME|NONE}]
[DEVEXCL={DDNAME|NONE}]
(Optional) Allows commands to be issued automatically from a data set after resynchronization takes place. This parameter is similar to the MIMINIT COMMANDS statement specified at startup. Specify one of the following values:
Specifies the member that CA MIM should use.
Specifies that you are not using a commands data set.
Default: See the RESYNCH operand for the SETOPTION GTAF command.
(Optional) Indicates which class of devices CA MIA will automatically manage after resynchronization. Specify one of the following values:
Indicates that you are not placing a class of devices under CA MIA management.
Places all tape devices under CA MIA management.
Default: See the RESYNCH operand for the SETOPTION GTAF command.
(Optional) Identifies the file that contains a list of tape devices to exclude from CA MIA management. Specify one of these values on the DEVEXCL parameter.
This variable represents the DDNAME that CA MIA uses to access the file. CA MIM typically uses the MIMEXCL ddname, however you can issue more FILEDEF commands to provide alternative members.
You are not excluding any devices from CA MIA management.
Default: DEVEXCL=NONE
(Optional) Identifies the member that CA MIA uses to obtain device control information. Specify one of the following values:
This variable represents the DDNAME that CA MIA should use to access the file. CA MIM normally uses the MIMUNITS ddname.
You are not using a member for this purpose.
Default: See the RESYNCH operand for the SETOPTION GTAF command.
Usage Notes: RESYNCH Command
Example: RESYNCH Command
To change the class of devices managed by CA MIA from NONE to TAPE, issue the following command:
RESYNCH DEVCLASS=TAPE
In this example, CA MIA uses TAPE for the DEVCLASS option, which temporarily overrides the value set on the SETOPTION RESYNCH command for DEVCLASS. The values for the COMMANDS and DEVLIST options remain the same.
The SETOPTION GTAF command lets you set operating values for the Global Tape Allocation Facility.
This command has the following format:
SETOPTION GTAF [ANALYZE=([DISPLAYCOUNT={ALL|number}])]
[ATTCKPT={USE|DISCARD} ]
[AUTOPATH[=(ATTACH={ON|OFF}]
[=(DETACH={ON|OFF}]
[=HOSTVMN={sysname|NONE}]
[=MAXATTACH=number]
[=MAXTIME=minutes]
[=MINTIME=minutes])]
[CONFIGSCAN=stime ]
[GLOBALDISPLAY[ ([DEVICE={device|FIRST}]
[FORMAT={INVERSE|STANDARD}]
[FREE={NO|YES}]
[HEADER={ALIAS|SYSNAME}]
[JOBNAME={NO|YES}]
[MOUNTPEND={NO|YES}]
[NUMBER=number]
[RESERVE={NO|YES}]
[SYSLIST={INDEX|sysid|(sysid1,sysid2,...)}]
[SYSNUM={ALL|MAX|nn}]
[SYSTEM={FIRST|sysid}]
[USERDATA={NO|YES}]
[VOLSER={NO|YES}] ) ]]
[RESETPRINT=(options)
[RESETTRACE=(options)
[RESYNCH=(COMMANDS={ddname|NONE}
DEVCLASS={NONE|TAPE}
DEVEXCL={ddname|NONE}
DEVLIST={ddname|NONE}
SAMEDEVS={NO|YES})
[SETPRINT=(options) ]
[SETTRACE=({ALL | [DDN]
[LOCKS]
[MASKS]
[PINSTAT]
[RESYNCH]
[SWAP]
[UNITALLOC]
[VARY]}) ]
[VARYSCOPE [{EXTERNAL | GLOBAL | LOCAL | sysid}]
[VARYOFF={YES|NO} ]
[VDEFAULT={181|vaddr} ]
Tells CA MIM that you are setting operating values for GTAF rather than any other facility. Specify the GTAF operand if you want to truncate an operand in a way that may be ambiguous with operands for other facilities.
Because GTAF is a positional operand, you must specify it before any other operand.
(Optional) Controls the amount and type of information that appears in the ANALYZE TAPEDELAY command.
Controls the number of waiters and owners displayed.
Default: DISPLAYCOUNT=5
Range: 1-99
Indicates how GTAF should handle checkpoint information about drive status if CA MIA is stopped or restarted. The desired value must be set in the CMNDS MIM file at startup. Specify one of these values on the ATTCKPT parameter:
This tells GTAF not to use checkpoint information. When CA MIA is restarted, GTAF will discard checkpoint information without updating the ATTACH status of devices.
This tells GTAF to use checkpoint information. When CA MIA is restarted, checkpoint information is processed, and the internal status of each device is changed to reflect the information in the checkpoint record.
Default: ATTCKPT=USE
Applies when your site is running one or more z/OS or z/VM guests under the same z/VM system. This parameter allows CA MIA to automatically request that a device be made available to the local z/VM system when the local system requests an attach.
When an Autopath-managed device is idle and is attached to a z/OS or z/VM guest system, Autopath for z/VM will request that the device be detached from that system and be made available to the local system in response to an attach request for the device on the local system. When running in a multi-level z/VM environment (one or more z/VM guest systems running under the same z/VM host), Autopath for z/VM on a requesting guest will also issue an attach request to make the device available to the local guest system. For detailed information on the Autopath for z/VM feature, see the CA MIA Tape Sharing for z/VM Programming Guide.
Controls whether CA MIM can automatically request that an Autopath-managed device be made available to the local system when it is needed by an attach request from the local system.
ON--Autopath will request that an available Autopath-managed device be made available to the local system.
OFF--Autopath will not request that an available Autopath-managed device be made available to the local system.
Default: ATTACH=OFF
Controls whether CA MIA will automatically detach an Autopath-managed device when another system requests use of the device.
Note: The DETACH parameter only applies to z/VM guest systems. The DETACH parameter has no effect on the z/VM host system because the z/VM host system cannot detach a device from itself.
ON-Specifies that CA MIA on a z/VM guest is allowed to detach an Autopath-managed device when another system requests use of the device.
Autopath on the z/VM guest system will issue a DETACH command to the z/VM host to detach the device from the z/VM guest.
OFF-Prevents automatic detaching of an Autopath-managed device from the z/VM guest.
Default: DETACH=OFF
Sets the name of the CA MIA host system for the local guest system. HOSTVMN tells Autopath for z/VM on the local guest system the name of the hosting z/VM system to send ATTACH and DETACH commands to when attaching and detaching devices to the local guest system.
If the local z/VM system is the z/VM HOST system, NONE is specified. If the local system is a z/VM guest system, then the CA MIA name of the host system, as identified on the DEFSYS statement, is specified.
For example, if you have the following on your DEFSYS statement:
DEFSYS (VM1,V1,MIMGR1), (VM2,V2,MIMGR2)
and VM1 is the z/VM host system and VM2 is a z/VM guest of VM1 you would specify on VM1:
HOSTVMN=NONE
and specify on VM2:
HOSTVMN=VM1
Default: HOSTVMN=NONE
Sets the maximum number of Autopath-managed devices CA MIA can have available for use by the local system. Legal values are 1 - 9999.
Once the maximum number is reached, Autopath for z/VM will stop requesting that other systems make the Autopath-managed devices available to the local system, until the number available drops below the maximum.
On the z/VM host system, a device is considered available for local use if it is not attached to any user or is attached to a local CMS user. A device is not considered available for local use if it attached to a guest system.
On a z/VM guest, a device is considered available for local use if a device is attached to the guest at the specified address and that device is not attached to any user on the guest or is attached to a local CMS user on the guest. This parameter prevents a system from monopolizing all Autopath-eligible devices.
Default: MAXATTACH=8
Sets the maximum time, in minutes, that Autopath processing waits for a device to become available to the local system before cancelling the request.
Valid values are 1 to 60.
Default: MAXTIME=2
Sets the minimum time, in minutes, that a device must remain attached to the local system before it becomes eligible for automatic reattachment to another system by Autopath. This parameter is intended to prevent thrashing behavior in which tape devices are frequently moved from one system to another without ever being allocated. Legal values available for use are 1 - 60.
Default: MINTIME=5
Determines how often GTAF should scan the real device configuration of your system to detect the addition of new devices. Stime is calibrated in minutes.
A configuration scan can take several minutes to complete, and may result in high CPU usage during the scan. CA recommends setting CONFIGSCAN to 0, which prevents scanning from occurring. If you decide to set a non-zero value, use a high value, preferably 60 minutes or higher.
In z/VM, the CP SET RDEVICE command or HCD configuration command is issued to add new devices to the real configuration while z/VM continues to run. This is called dynamic reconfiguration. At most sites, dynamic reconfiguration will be done infrequently, if at all.
Note: You can issue the RESYNCH command at any time if you want to adapt CA MIM to a dynamic reconfiguration, but do not wish to use the CONFIGSCAN option.
Default: CONFIGSCAN=0
(Optional) Controls the amount and type of information that appears in the global status display for GTAF-managed devices. You can use the DISPLAY GLOBALUNITS command to obtain this display. The GLOBALDISPLAY operand also controls the format of the display. You can specify one or more of the following values on the GLOBALDISPLAY operand:
Controls the format of the display for global device information. Specify one of the following values on the FORMAT operand:
INVERSE--This value displays the global names of devices along the horizontal axis and the names of systems along the vertical axis. This format limits the maximum number of devices that can be displayed to eight per line. The format does not limit the number of systems that can be displayed.
STANDARD -- This value displays the names of systems along the horizontal axis and the global names of devices along the vertical axis. This format limits the maximum number of systems that can be displayed to seven. The format does not limit the number of devices that can be displayed.
Default: FORMAT=STANDARD
(Optional) Determines whether devices that are only defined to systems that have been freed are included in the display of global status information. Specify the following values on FREE:
YES--All global devices are displayed, even if they are not defined on any active system.
NO--Devices will be excluded from the display if they are not defined on any active system.
Default: FREE=YES
Determines which managed device is shown first by default in the global status display for devices. Specify one of the following values on the DEVICE operand:
device--GTAF displays the device having this global name first.
FIRST--GTAF displays the device having the lowest alphanumeric global name first.
You can override this value when you issue the DISPLAY command.
Default: DEVICE=FIRST
(Optional) Indicates whether you want to include full system names or system aliases in the display of global status information for GTAF-managed devices. Specify one of these values on the HEADER operand:
ALIAS--This value displays the alias associated with each system. The system aliases can be up to two bytes long.
SYSNAME--This value displays the full system name associated with each system. System headers appear on the horizontal axis for standard displays and on the vertical axis for inverse displays. The system names can be up to eight bytes long. In the standard display, specifying HEADER=SYSNAME reduces the number of systems that GTAF can display by one.
Default: HEADER=SYSNAME
(Optional) Determines whether the job status is included in the display of global status information when at least one device is allocated to a job. Specify one of these values on the JOBNAME operand:
NO--This value omits the job status from the display.
YES--This value displays the name of the job that has the device allocated. GTAF uses JOBNAME as the label for this information. The job status appears on the horizontal axis for standard displays and on the vertical axis for inverse displays.
Because a job can require up to eight bytes of space in the display, specifying JOBNAME=YES limits the number of devices or systems that GTAF can display per line. For the standard display, the maximum number of systems that GTAF can display per line is reduced by one. For the inverse display, the maximum number of devices that GTAF can display per line is six.
Default: JOBNAME=NO
Determines whether the device mount-pending time should be included in the GTAF options display. Specify one of these values on the MOUNTPEND operand:
NO--Omits the mount-pending line from the display.
YES--Displays the tape drive mount-pending time. This value limits the number of devices or systems that can be displayed. On a standard display, the maximum number of systems that GTAF can display per line is decreased by one. On an inverse display, the maximum number of devices that GTAF can display is six per line.
Default: MOUNTPEND=NO
Determines how many devices are included by default in the global status display for devices. You can override this value when you issue the DISPLAY command.
Specify a value from 1 to 9999 (integers only). If you request inverse format for the display (by specifying FORMAT=INVERSE) and this value exceeds the maximum number of devices that GTAF can fit on a line, then GTAF places the additional device information in a separate global status display.
Default: NUMBER=8
Determines whether reserve status is included in the global status display when at least one device is reserved for a job mask. Specify one of these values on the RESERVE operand:
NO--This value omits the reserve line from the display.
YES--This value displays the name of the job mask that has the device reserved. GTAF uses RESERVE as the label for this information. The reserve status appears on the horizontal axis for standard displays and on the vertical axis for inverse displays.
Specifying RESERVE=YES limits the number of devices or systems that can be displayed. On a standard display, the maximum number of systems that GTAF can display per line is decreased by one. On an inverse display, the maximum number of devices that GTAF can display per line is six.
Default: RESERVE=NO
Determines the default order of the systems in the DISPLAY GLOBALUNITS display. Specify the full system name, two-character system alias, or two-digit system index number for the sysid variables. A system you identify for sysid must be defined to CA MIM through the DEFSYS statement. Specifying a value of INDEX causes systems to be displayed in order of system index number.
Note: INDEX must be fully qualified, so as to distinguish it from a possible valid system ID.
Default: SYSLIST=INDEX
Determines the default number of systems returned when you issue the DISPLAY GLOBALUNITS command.
ALL--This value causes all systems to be displayed, and is the equivalent of specifying SYSNUM=32.
MAX--This value causes the maximum number of systems possible for the format of the display (STANDARD or INVERSE) to be displayed, without wrapping of the STANDARD display. For INVERSE format, the maximum number of systems displayed is unlimited (meaning MAX value is the same as ALL value). For STANDARD format, the maximum number of systems displayed is limited by the width of the console display.
Note: This value generates the same displays as in previous releases of CA MIM without the SYSNUM option.
nn--This value specifies the number of systems to be displayed. For INVERSE format, the number of systems displayed may be reduced if nn is less than the maximum number of systems. For STANDARD format, a wrapped display will be generated if nn exceeds the maximum number of systems that can be displayed on one line.
Default: SYSNUM=MAX
Determines which system is shown first by default in the global status display for devices. Specify one of the following values on the SYSTEM operand:
FIRST--This value displays information about the system having the lowest system index number first.
sysid--This value displays information about the system having this system ID first. The system ID can be the system name, alias, or internal index number. You can use the DISPLAY SYSTEMS command to display the index numbers for your systems.
You can override this value when you issue the DISPLAY command.
Default: SYSTEM=FIRST
Determines whether data in the user data field for the specified device is included in the global status display for GTAF-managed devices. Specify one of the following values on the USERDATA operand:
NO--Do not display user data on the global display.
YES--Display device user data on the global device status display.
Specifying USERDATA=YES limits the number of devices or systems that can be displayed. On a standard display, the maximum number of systems that GTAF can display per line is decremented by one. On an inverse display, the maximum number of devices that GTAF can display per line is six.
You can set the user data values using the USERDATA command.
Default: USERDATA=NO
Determines whether volume serial status is included in the display of global status information when at least one device has a volume serial number to be displayed. Specify one of the following values on the VOLSER operand:
NO--This omits volume serial information from the display.
YES--This displays the volume serial number associated with each device. GTAF uses VOLSER as the label for this information. The volser status appears on the horizontal axis for standard displays and on the vertical axis for inverse displays. For the standard display, the maximum number of systems that GTAF can display is decremented by one. On an inverse display, the maximum number of devices that GTAF can display per line is six.
Default: VOLSER=NO
Controls the format of the display for global device information. Specify one of the following values on the FORMAT operand:
INVERSE--This value displays the global names of devices along the horizontal axis and the names of systems along the vertical axis. This format limits the maximum number of devices that can be displayed to eight per line. The format does not limit the number of systems that can be displayed.
STANDARD -- This value displays the names of systems along the horizontal axis and the global names of devices along the vertical axis. This format limits the maximum number of systems that can be displayed to seven. The format does not limit the number of devices that can be displayed.
Default: FORMAT=STANDARD
(Optional) Determines whether devices that are only defined to systems that have been freed are included in the display of global status information. Specify the following values on FREE:
YES--All global devices are displayed, even if they are not defined on any active system.
NO--Devices will be excluded from the display if they are not defined on any active system.
Default: FREE=YES
Determines which managed device is shown first by default in the global status display for devices. Specify one of the following values on the DEVICE operand:
device--GTAF displays the device having this global name first.
FIRST--GTAF displays the device having the lowest alphanumeric global name first.
You can override this value when you issue the DISPLAY command.
Default: DEVICE=FIRST
(Optional) Indicates whether you want to include full system names or system aliases in the display of global status information for GTAF-managed devices. Specify one of these values on the HEADER operand:
ALIAS--This value displays the alias associated with each system. The system aliases can be up to two bytes long.
SYSNAME--This value displays the full system name associated with each system. System headers appear on the horizontal axis for standard displays and on the vertical axis for inverse displays. The system names can be up to eight bytes long. In the standard display, specifying HEADER=SYSNAME reduces the number of systems that GTAF can display by one.
Default: HEADER=SYSNAME
(Optional) Determines whether the job status is included in the display of global status information when at least one device is allocated to a job. Specify one of these values on the JOBNAME operand:
NO--This value omits the job status from the display.
YES--This value displays the name of the job that has the device allocated. GTAF uses JOBNAME as the label for this information. The job status appears on the horizontal axis for standard displays and on the vertical axis for inverse displays.
Because a job can require up to eight bytes of space in the display, specifying JOBNAME=YES limits the number of devices or systems that GTAF can display per line. For the standard display, the maximum number of systems that GTAF can display per line is reduced by one. For the inverse display, the maximum number of devices that GTAF can display per line is six.
Default: JOBNAME=NO
Determines whether the device mount pending time should be included in the GTAF options display. Specify one of these values on the MOUNTPEND parameter:
NO-Omits the mount pending line from the display.
YES-Displays the tape drive mount pending information. The mount pending information appears on the horizontal axis for standard displays and on the vertical axis for inverse displays.
Specifying MOUNTPEND=YES limits the number of devices or systems that can be displayed. On a standard display, the maximum number of systems that GTAF can display per line is reduced by one. On an inverse display, the maximum number of devices that GTAF can display per line is six.
Default: MOUNTPEND=NO
Determines how many devices are included by default in the global status display for devices. You can override this value when you issue the DISPLAY command.
Specify a value from 1 to 9999 (integers only). If you request inverse format for the display (by specifying FORMAT=INVERSE) and this value exceeds the maximum number of devices that GTAF can fit on a line, then GTAF places the additional device information in a separate global status display.
Default: NUMBER=8
Determines whether reserve status is included in the global status display when at least one device is reserved for a job mask. Specify one of these values on the RESERVE operand:
NO--This value omits the reserve line from the display.
YES--This value displays the name of the job mask that has the device reserved. GTAF uses RESERVE as the label for this information. The reserve status appears on the horizontal axis for standard displays and on the vertical axis for inverse displays.
Specifying RESERVE=YES limits the number of devices or systems that can be displayed. On a standard display, the maximum number of systems that GTAF can display per line is decreased by one. On an inverse display, the maximum number of devices that GTAF can display per line is six.
Default: RESERVE=NO
Determines the default order of the systems in the DISPLAY GLOBALUNITS display. Specify the full system name, two-character system alias, or two-digit system index number for the sysid variables. A system you identify for sysid must be defined to CA MIM through the DEFSYS statement. Specifying a value of INDEX causes systems to be displayed in order of system index number.
Note: INDEX must be fully qualified, so as to distinguish it from a possible valid system ID.
Default: SYSLIST=INDEX
Determines the default number of systems returned when you issue the DISPLAY GLOBALUNITS command.
ALL--This value causes all systems to be displayed, and is the equivalent of specifying SYSNUM=32.
MAX--This value causes the maximum number of systems possible for the format of the display (STANDARD or INVERSE) to be displayed, without wrapping of the STANDARD display. For INVERSE format, the maximum number of systems displayed is unlimited (meaning MAX value is the same as ALL value). For STANDARD format, the maximum number of systems displayed is limited by the width of the console display.
Note: This value generates the same displays as in previous releases of CA MIM without the SYSNUM option.
nn--This value specifies the number of systems to be displayed. For INVERSE format, the number of systems displayed may be reduced if nn is less than the maximum number of systems. For STANDARD format, a wrapped display will be generated if nn exceeds the maximum number of systems that can be displayed on one line.
Default: SYSNUM=MAX
Determines which system is shown first by default in the global status display for devices. Specify one of the following values on the SYSTEM operand:
FIRST--This value displays information about the system having the lowest system index number first.
sysid--This value displays information about the system having this system ID first. The system ID can be the system name, alias, or internal index number. You can use the DISPLAY SYSTEMS command to display the index numbers for your systems.
You can override this value when you issue the DISPLAY command.
Default: SYSTEM=FIRST
Determines whether data in the user data field for the specified device is included in the global status display for GTAF-managed devices. Specify one of the following values on the USERDATA operand:
NO--Do not display user data on the global display.
YES--Display device user data on the global device status display.
Specifying USERDATA=YES limits the number of devices or systems that can be displayed. On a standard display, the maximum number of systems that GTAF can display per line is decremented by one. On an inverse display, the maximum number of devices that GTAF can display per line is six.
You can set the user data values using the USERDATA command.
Default: USERDATA=NO
Determines whether volume serial status is included in the display of global status information when at least one device has a volume serial number to be displayed. Specify one of the following values on the VOLSER operand:
NO--This omits volume serial information from the display.
YES--This displays the volume serial number associated with each device. GTAF uses VOLSER as the label for this information. The volser status appears on the horizontal axis for standard displays and on the vertical axis for inverse displays. For the standard display, the maximum number of systems that GTAF can display is decremented by one. On an inverse display, the maximum number of devices that GTAF can display per line is six.
Default: VOLSER=NO
(Optional) Allows you to turn off trace event printing for the specified trace option or all options. For an explanation of the available options, see the SETTRACE operand.
Note: Resetting the DDN, PINSTAT, RESYNCH, and VARY options for this parameter through the SETOPTION GTAF command resets the same options for the equivalent SETOPTION TPCF parameter. In this case, the function is available to both the GTAF and TPCF facilities. The settings are made available under both SETOPTION GTAF and SETOPTION TPCF for sites that may only be activating one of the facilities.
(Optional) Allows you to turn off tracing for the specified option or for all options. For an explanation of the available options, see the SETTRACE operand.
Note: Resetting the DDN, PINSTAT, RESYNCH, and VARY options for this parameter through the SETOPTION GTAF command resets the same options for the equivalent SETOPTION TPCF parameter. In this case, the function is available to both the GTAF and TPCF facilities. The settings are made available under both SETOPTION GTAF and SETOPTION TPCF for sites that may only be activating one of the facilities.
Determines the values used for resynchronization. You can specify one or more of the following:
This allows commands to be issued from a file after resynchronization. Specify the ddname or NONE. The default value is NONE. A GCS FILEDEF is required to relate the DDNAME to the file.
Indicates which class of devices CA MIA will manage. Specify TAPE or NONE. The default value is the value specified on the MIMINIT DEVCLASS statement.
This value identifies the file that CA MIA uses to obtain a list of devices you wish to exclude from CA MIA management.
Default: DEVEXCL=NONE
This value identifies the file that CA MIA uses to obtain device control information. Specify the ddname or NONE. The default value is the value specified on the MIMINIT DEVLIST statement. A GCS FILEDEF is also required to relate the DDNAME to the file.
This value determines whether CA MIA begins managing new devices as soon as they are reconfigured.
Specify NO to indicate that new devices will be recognized, and that the values for DEVCLASS and DEVLIST will be used. Specify YES to indicate that new devices will not be recognized, and that the values for DEVCLASS and DEVLIST will be ignored. The default value is NO.
Note: Setting a value for any of the RESYNCH parameters using the SETOPTION TPCF command sets the same value for the equivalent SETOPTION GTAF RESYNCH parameter. In this case, the function is available to both the GTAF and TPCF facility. The settings are made available under both SETOPTION GTAF and SETOPTION TPCF for sites that may only be activating one of the facilities.
(Optional) Turns on the print function for the specified trace event options. For an explanation of the available options, see the SETTRACE operand.
Note: Resetting the DDN, PINSTAT, RESYNCH, and VARY options for this parameter through the SETOPTION GTAF command resets the same options for the equivalent SETOPTION TPCF parameter. In this case, the function is available to both the GTAF and TPCF facilities. The settings are made available under both SETOPTION GTAF and SETOPTION TPCF for sites that may only be activating one of the facilities.
(Optional) Turns on the trace feature for the specified trace event options. You can specify one or more of the following options:
Traces all GTAF processing.
Traces local DNE creation and deletion.
Traces locks.
Traces masks.
Traces device pin status processing.
Traces RESYNCH command processing.
Traces SWAP processing.
Traces unit allocation/de-allocation.
Traces VARY command processing.
Note: Resetting the DDN, PINSTAT, RESYNCH, and VARY options for this parameter through the SETOPTION GTAF command resets the same options for the equivalent SETOPTION TPCF parameter. In this case, the function is available to both the GTAF and TPCF facilities. The settings are made available under both SETOPTION GTAF and SETOPTION TPCF for sites that may only be activating one of the facilities.
Note: In CA MIA, the LOCKS, RESYNCH, SWAP, UNITALOC, PIMSTAT, and VARY options are not used. They are provided for compatibility with CA MIA for z/OS. The ALL and MASKS options are equivalent.
Permits you to vary tape drives when shutting down as follows:
Varies tape drives offline when shutting down
Leaves tape drives online when shutting down
Default: VARYOFF=YES
(Optional) Specifies the default scope value for the VARY command. GTAF uses the value you specify for the VARYSCOPE operand if a user issues the VARY command and does not provide a scope value with one of these operands: ONLINE, OFFLINE, AVAILABLE, NOTAVAILABLE, OVERGENNED, and NOTOVERGENNED. Specify one of the following values on the VARYSCOPE operand:
Modifies the device status on all external systems; that is, on all but the local system.
Modifies the device status on all systems. When specified, this value also sets a GLOBAL status for the job identified in VARY JOB=name.
Modifies the device status on the local system.
Note: When specified, this value also sets a LOCAL status for the job identified in VARY JOB=name.
Modifies the device status only on the system you identify. The sysid variable represents the full system name, alias, or index number associated with a system defined to CA MIM.
You can override the default value set on the VARYSCOPE operand by specifying a scope value on the VARY command.
Default: VARYSCOPE=LOCAL
Sets the default value for the ATTACH command. GTAF uses the value you specify for the VDFAULT parameter if a user issues the ATTACH command without providing a virtual address.
Specifies the virtual address to be used.
Default: VDEFAULT=181
Usage Notes: SETOPTION
Usage Notes
Example: SETOPTION GTAF Command
To indicate that GTAF should display information about the global status of devices with the global names of devices along the horizontal axis and the names or aliases of systems along the vertical axis, issue this command:
SETOPTION GLOBALDISPLAY(FORMAT=INVERSE)
The SETOPTION TPCF command lets you set operating values for the Tape Preferencing and Control Facility.
This command has the following format:
SETOPTION TPCF [JOBFORCE={NO|YES}]
[LOCALDISPLAY(DEVICE={device|FIRST}
NUMBER=number )]
[RESETPRINT=(options)] *See SETTRACE.
[RESETTRACE=(options)] *See SETTRACE.
[RESYNCH[=COMMANDS={ddname|NONE}
[=DEVCLASS={NONE|TAPE}]
[=DEVEXCL={ddname|NONE}]
[=DEVLIST={ddname|NONE}]
[=SAMEDEVS={NO|YES}]]
[SETPRINT=(options)] *See SETTRACE.
[SETTRACE[={ALL | ([ACE]
[DDN]
[DEVSEL24]
[DEVSEL78]
[PINSTAT]
[RECOVERY]
[RESYNCH]
[SSTAFULL]
[SWAP]
[VARY])}]
[SOLOSHUTOPTN={YES|NO}
[TIMEOUT=option}]
[USERDATA[={FULL | PARTIAL}] [MIM2069={NO|YES}]]
Tells CA MIM that you are setting operating values for TPCF rather than for any other facility. Specify the TPCF operand if you want to truncate an operand in a way that may be ambiguous with operands for other facilities.
Because TPCF is a positional operand, you must specify it before any other operand.
Provides the default setting for the FORCE option on the VARY JOB command when no FORCE option is specified on the command.
The FORCE option has no effect on job reserve processing on a z/VM system. FORCE processing only affects job reserve processing on z/OS systems that are running CA MIA for z/OS. Therefore, the setting of this parameter is relevant only when you issue a VARY JOB command with the GLOBAL option from a z/VM system, and that system is in the same complex as systems that are running CA MIA for z/OS. The GLOBAL option causes the command to be processed on all systems in the complex. The FORCE setting affects job reserve processing on any CA MIA for z/OS systems in the complex.
Default: FORCE=NO
(Optional) Determines which managed device is shown first and how many devices are included by default in the local status display for devices. You can use the DISPLAY LOCALUNITS command to obtain this display. Specify one or both of these values on the LOCALDISPLAY operand:
Determines which managed device is shown first by default. Specify DEVICE=FIRST to start with the device that has the lowest alphanumeric local name. To start with a different device, specify a local device name in place of the device variable.
Default: DEVICE=FIRST
Determines how many devices are displayed by default. Specify a value from 1 to 9999 in place of the number variable.
Default: NUMBER=8
(Optional) Tells TPCF to stop writing trace records to the MIMTRACE data set. For an explanation of the available options, see the SETTRACE operand. To cancel a SETOPTION SETPRINT command that you issued previously, specify the same value for the RESETPRINT operand that you specified for the SETPRINT operand.
Note: Resetting the RESYNCH, SWAP, or VARY options for this parameter through the SETOPTION TPCF command resets the same options for the equivalent SETOPTION GTAF parameter. In this case, the function is available to both the TPCF and GTAF facilities. The settings are made available under both SETOPTION TPCF and SETOPTION GTAF for sites that activate only one of the facilities.
(Optional) Tells TPCF to stop generating trace records. For an explanation of trace options, see the SETTRACE operand. To cancel a SETOPTION SETTRACE command that you issued previously, specify the same value for the RESETTRACE operand that you specified for the SETTRACE operand.
Note: Resetting the RESYNCH, SWAP, or VARY options for this parameter through the SETOPTION TPCF command resets the same options for the equivalent SETOPTION GTAF parameter. In this case, the function is available to both the TPCF and GTAF facilities. The settings are made available under both SETOPTION TPCF and SETOPTION GTAF for sites that activate only one of the facilities.
Determines the values used for resynchronization. The values set on this parameter can be temporarily overridden by a RESYNCH command. You can specify one or more of the following:
This allows commands to be issued from a file after resynchronization. Specify the ddname or NONE. The default value is NONE. A GCS FILEDEF is required to relate the DDNAME to the file.
Indicates which class of devices CA MIA will manage. Specify TAPE or NONE. The default value is the value specified on the MIMINIT DEVCLASS statement.
This value identifies the file that CA MIA uses to obtain a list of devices to exclude from CA MIA management. The default value is specified on the MIMINIT DEVEXCL statement.
Default: DEVEXCL=NONE
This value identifies the file that CA MIA uses to obtain device control information. Specify the ddname or NONE. The default value is the value specified on the MIMINIT DEVLIST statement. A GCS FILEDEF is also required to relate the DDNAME to the file.
This value determines whether CA MIA begins managing new devices as soon as they are reconfigured.
Specify NO to indicate that new devices will be recognized, and that the values for DEVCLASS and DEVLIST will be used. Specify YES to indicate that new devices will not be recognized, and that the values for DEVCLASS and DEVLIST will be ignored. The default value is NO.
(Optional) This turns on the print function for the specified trace event options. For an explanation of the available options, see the SETTRACE parameter.
Note: Resetting the RESYNCH, SWAP, or VARY options for this parameter through the SETOPTION TPCF command resets the same options for the equivalent SETOPTION GTAF parameter. In this case, the function is available to both the TPCF and GTAF facilities. The settings are made available under both SETOPTION TPCF and SETOPTION GTAF for sites that activate only one of the facilities.
(Optional) Causes TCPF to generate trace records. CA Technical Support may ask you to specify this operand for diagnostic purposes. Specify one of these values on the SETTRACE operand:
Traces ACE record processing.
Traces all TPCF processing.
Traces all DDN DNE creation and deletions
Traces the CA MIA SSI 24 device selection processing. Job name filtering is available for this tracing using the SETOPTION MIM TRACE=(JOBNAME=jjjjjjjj) command.
Traces the CA MIA SSI 78 device selection processing. Job name filtering is available for this tracing using the SETOPTION MIM TRACE=(JOBNAME=jjjjjjjj) command.
Traces all device pins
Traces allocation recovery processing. Job name filtering is available for this tracing using the SETOPTION MIM TRACE=(JOBNAME=jjjjjjjj) command.
Traces RESYNCH command processing.
Traces entire SSTA in CA MIA SSI 78 processing. Job name filtering is available for this tracing using the command SETOPTION MIM TRACE=(JOBNAME=jjjjjjjj).
Traces SWAP processing.
Traces VARY command processing.
For the format of the MIM2076 trace records, see the description of the MIM2076 message in the Messages and Codes guide.
Note: Setting the RESYNCH, SWAP, or VARY options for this parameter using the SETOPTION TPCF command sets the same options for the equivalent SETOPTION GTAF parameter. In this case, the function is available to both the GTAF and TPCF facility. The settings are made available under both SETOPTION GTAF and SETOPTION TPCF for sites that may only be activating one of the facilities.
Note: The ACE, DEVSEL24, DEVSEL78, RECOVERY, RESYNCH, SSTAFULL, and VARY options are provided only for compatibility with CA MIA for z/OS. They are not used by CA MIA.
(Optional) Setting this option to YES causes all CA MIA-managed devices to be varied OFFLINE upon shutdown. Otherwise, all devices are left in their current state. This Option is only available if COMMUNICATION=SOLO is specified.
Default: SOLOSHUTOPTN=NO
Determines the number of minutes that a tape drive will be allowed to remain unused while it is attached to a CMS user ID. If this time limit is exceeded, the drive will be detached from the user ID. Valid values are 2 through 999. Setting TIMEOUT to a value of zero suppresses the timer feature, allowing idle tape drives to remain attached indefinitely.
You can use the TIMEOUT option, or the KEEP option for the ATTACH command to override this setting.
Default: TIMEOUT=DISABLED
(Optional) Controls the updating of the user data field using the USERDATA command, and the issuing of message MIM2069 after the successful completion of USERDATA command processing. Specify one of these values on the USERDATA operand:
Indicates that, when a USERDATA command is processed, you want to clear the entire user data field before the loading of new user data information specified on the USERDATA command.
Indicates that, when a USERDATA command is processed, you do not want to clear the entire user data field before the loading of new user data information specified on the USERDATA command.
Indicates whether CA MIA should issue message MIM2069 after successful completion of USERDATA command processing. Possible values are NO and YES.
Defaults: USERDATA=FULL MIM2069=NO
Usage Notes: SETOPTION TPCF Command
Usage Notes: SETOPTION
Example: SETOPTION TPCF Command
SETOPTION AUTOREPLY(IEF433D=NOHOLD)
SETOPTION TPCF LOCALDISPLAY(NUMBER=12)
SETOPTION TPCF TIMEOUT=45
|
Copyright © 2014 CA.
All rights reserved.
|
|