This statement is for the HSMS administrator only and is used for modifying the archive-specific tape processing parameters, in particular those for tape session control.
Format (only for HSMS administrators)
MODIFY-TAPE-CONTROL Alias: MTC | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ENVIRONMENT =
Defines the HSMS environment where the specified archive is located.
ENVIRONMENT = *SINGLE-FEATURE
The specified archive is defined in the central HSMS parameters.
ENVIRONMENT = *SYSTEM-MANAGED(...)
The specified archive is defined in an SM pubset environment.
CATALOG-ID = <cat-id>
Catalog ID of the SM pubset to which the HSMS statement applies.
ARCHIVE-NAME = *ALL
The tape processing parameters are to be modified for all HSMS archives in the specified environment.
ARCHIVE-NAME = <filename 1..22 without-cat-gen-vers>
Name of the archive whose tape processing parameters are to be modified.
READ-CONTROL = *UNCHANGED / *STD / *PROCESS-REQUESTS /*HOLD-REQUESTS /
*BY-TAPE-SESSIONS(...)
Defines the tape sessions for read access, i.e. for all requests created by
//RESTORE-FILES,
//RECALL-MIGRATED-FILES FROM-STORAGE=*ANY/*S2-STORAGE-LEVEL,
the BS2000 command SECURE-RESOURCE-ALLOCATION.
READ-CONTROL = *STD
The preset values from the HSMS control file are to apply to this archive.
READ-CONTROL = *PROCESS-REQUESTS
Tape access is to be permitted at any time. In the event of a switch to a different tape control mode, all pending requests are first completed.
READ-CONTROL = *HOLD-REQUESTS
Tape access is to be temporarily prohibited (delayed). The requests are entered in the HSMS request file of the archive environment.
READ-CONTROL = *BY-TAPE-SESSIONS(...)
Tape access is to be permitted at defined intervals, i.e. during the so-called tape sessions. During a tape session, all relevant requests currently waiting in the request file of the archive environment are processed.
START-TIME =
Defines the beginning of a tape session.
START-TIME = *IMMEDIATELY
Tape access is to be permissible immediately after statement entry or the start of the HSMS or SM pubset session.
START-TIME = <time>
Time of day at which a tape session is to begin. The time specified is valid for the current day and the following days.
PERIOD = <integer 0..1440 minutes> / *END-OF-DAY
Period of time in minutes to be allowed between the beginning of two consecutive tape sessions. The period specified is always relative to the specified start time. PERIOD=0 or PERIOD=*END-OF-DAY permit tape access from the beginning of the tape session until the end of the day, all requests received before midnight will be processed.
WRITE-CONTROL = *UNCHANGED / *STD / *PROCESS-REQUESTS /*HOLD-REQUESTS /
*BY-TAPE-SESSIONS(...)
Defines the tape sessions for write access, i.e. any access involved in backing up, archiving, migrating or copying save files. For a description of the operands, see the operand READ-CONTROL, with the exception of the following:
WRITE-CONTROL = *BY-TAPE-SESSIONS(...)
START-TIME =
Defines the beginning of a tape session.
START-TIME = *IMMEDIATELY
Tape access is to be permissible immediately after statement entry or the start of the HSMS session.
START-TIME = <time>
Time of day at which a tape session is to begin. The time specified is valid for the current day and the following days.
PERIOD = <integer 0..1440 minutes> / *END-OF-DAY
Period of time in minutes to be allowed between the beginning of two consecutive tape sessions. The period specified is always relative to the specified start time. PERIOD=0 or PERIOD=*END-OF-DAY permit tape access from the beginning of the tape session until the end of the day, all requests received before midnight will be processed.
MINIMUM-PAGES = *NONE / <integer 1..2147483647 2Kbyte>
This operand is restricted to archives for BS2000 files.
Minimum number of 2-Kbyte blocks (PAM pages) to be written per tape session. This delays tape processing until the total volume of all write requests has reached the specified number of pages. If the minimum number of pages is not reached by the end of the HSMS session, the requests are not executed, being instead held over for the next HSMS session.
Only write requests from S0 to S1 not generated by the HSMS administrator are counted as pages to be written. This means that the following are not counted:
all write requests from the HSMS administrator
requests to copy save files
requests for migration from S1 to S2.
The default value (*NONE) starts tape processing irrespective of the number of 2-Kbyte blocks (PAM pages) to be written.
EXPRESS-CONTROL = *UNCHANGED / *STD / *PROCESS-REQUESTS /*HOLD-REQUESTS /
*BY-TAPE-SESSIONS(...)
Defines the tape sessions for express requests (both read and write access). For a description of the operands see above under READ-CONTROL.