Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-TAPE-CONTROL Show tape control parameters

&pagelevel(4)&pagelevel

This statement is for the HSMS administrator only. It displays

  • the current or permanent parameter values for controlling archive-specific tape sessions

  • the number of requests in an SF or SM pubset environment waiting to be processed.

In addition to output to SYSOUT or SYSLST, the statement also supports structured output to an S variable.

Format (only for HSMS administrators)

SHOW-TAPE-CONTROL

Alias: STC

ENVIRONMENT = *SINGLE-FEATURE / *SYSTEM-MANAGED(...)


*SYSTEM-MANAGED(...)



|

CATALOG-ID = <cat-id>

,ARCHIVE-NAME = *ALL / <filename 1..22 without-cat-gen-vers>

,REQUEST-TYPE = *ANY / list-poss(2): *WRITE / *READ / *EXPRESS

,CONTROL = *ANY / list-poss(3): *STD / *PROCESS-REQUESTS / *HOLD-REQUESTS /





*BY-TAPE-SESSIONS

,OUTPUT = *NONE / list-poss(2): *SYSOUT / *SYSLST

,STRUCTURE-OUTPUT = *SYSINF / *NONE / <composed-name 1..255>(...)


<composed-name 1..255>(...)



|

WRITE-MODE = *REPLACE / *EXTEND

ENVIRONMENT =
Defines the HSMS environment where the selected archives are located.

ENVIRONMENT = *SINGLE-FEATURE
The archives are defined in the SF environment.

ENVIRONMENT = *SYSTEM-MANAGED(...)
The archives are 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 for all archives in the specified environment are displayed.

ARCHIVE-NAME = <filename 1..22 without-cat-gen-vers>
Name of the archive in the specified environment for which the tape processing parameters are to be displayed.

REQUEST-TYPE =
The tape processing parameters can be selected according to the type of access.

REQUEST-TYPE = *ANY
The tape processing parameters are displayed irrespective of the type of access.

REQUEST-TYPE = *WRITE
Displays only tape processing parameters for write access.

REQUEST-TYPE = *READ
Displays only tape processing parameters for read access.

REQUEST-TYPE = *EXPRESS
Displays only tape processing parameters for express access.

CONTROL =
The tape processing parameters can be displayed according to the tape access control method.

CONTROL = *ANY
The tape processing parameters are displayed irrespective of access control.

CONTROL = *STD
Displays only tape processing parameters for accessing requests which correspond to the value of the global HSMS parameter CONTROL.

CONTROL = *PROCESS-REQUESTS
Displays only tape processing parameters for accessing requests to be processed immediately.

CONTROL = *HOLD-REQUESTS
Displays only tape processing parameters for accessing requests to be processed at a later time.

CONTROL = *BY-TAPE-SESSIONS
Displays only tape processing parameters for accessing requests in a definable time slot.

OUTPUT =
Determines the output medium for the desired information. Output generally takes place to SYSLST for batch requests.

OUTPUT = *NONE
Output is not performed in text format.

OUTPUT = *SYSOUT
The information is output to the logical system file SYSOUT, i.e. it is normally displayed on the screen in interactive mode.

OUTPUT = *SYSLST
The information is output to the logical system file SYSLST. Each mask comprises 43 lines.

STRUCTURE-OUTPUT =
Controls structured output in S variables (for the variable layout see "Output in S variables").

STRUCTURE-OUTPUT = *SYSINF
Structured output is directed to the SYSINF S variable stream.

STRUCTURE-OUTPUT = *NONE
No structured output is required.

STRUCTURE-OUTPUT = <composed-name 1..255>(...)
Name of the S variable that is to be used for the structured output.

WRITE-MODE =
Determines whether the output should replace or complement the current content of the S variables.

WRITE-MODE = *REPLACE
The current content of the S variable is to be replaced by the new output.

WRITE-MODE = *EXTEND
The new output extends the current content of the S variable.

Layout of the screen mask

 SHOW-TAPE-CONTROL   VALID-PERIOD=@@@@@@@@@   REQUEST-TYPE=@@@@@@@@@@@@@@
                     ENVIRONMENT =@@@@@@@@    CONTROL     =@@@@@@@@@@@@@@@@@@@@@@
 --------------------------------------------------------------------------------
 OWNER-ID  ARCHIVE-NAME  RQ-TYPE  CONTROL   START-T.  PERIOD  MIN.-PAGES |  #REQ 
 @@@@@@@@  @@@@@@@@@@@@  @@@@@@@  @@@@@@@@  @@@@@@@@  @@@@@@  @@@@@@@@@@ | @@@@@@
 @@@@@@@@  @@@@@@@@@@@@  @@@@@@@  @@@@@@@@  @@@@@@@@  @@@@@@  @@@@@@@@@@ | @@@@@@
 @@@@@@@@  @@@@@@@@@@@@  @@@@@@@  @@@@@@@@  @@@@@@@@  @@@@@@  @@@@@@@@@@ | @@@@@@
 @@@@@@@@  @@@@@@@@@@@@  @@@@@@@  @@@@@@@@  @@@@@@@@  @@@@@@  @@@@@@@@@@ | @@@@@@
 @@@@@@@@  @@@@@@@@@@@@  @@@@@@@  @@@@@@@@  @@@@@@@@  @@@@@@  @@@@@@@@@@ | @@@@@@
 @@@@@@@@  @@@@@@@@@@@@  @@@@@@@  @@@@@@@@  @@@@@@@@  @@@@@@  @@@@@@@@@@ | @@@@@@
 @@@@@@@@  @@@@@@@@@@@@  @@@@@@@  @@@@@@@@  @@@@@@@@  @@@@@@  @@@@@@@@@@ | @@@@@@
 @@@@@@@@  @@@@@@@@@@@@  @@@@@@@  @@@@@@@@  @@@@@@@@  @@@@@@  @@@@@@@@@@ | @@@@@@
 @@@@@@@@  @@@@@@@@@@@@  @@@@@@@  @@@@@@@@  @@@@@@@@  @@@@@@  @@@@@@@@@@ | @@@@@@
 @@@@@@@@  @@@@@@@@@@@@  @@@@@@@  @@@@@@@@  @@@@@@@@  @@@@@@  @@@@@@@@@@ | @@@@@@
 @@@@@@@@  @@@@@@@@@@@@  @@@@@@@  @@@@@@@@  @@@@@@@@  @@@@@@  @@@@@@@@@@ | @@@@@@
 @@@@@@@@  @@@@@@@@@@@@  @@@@@@@  @@@@@@@@  @@@@@@@@  @@@@@@  @@@@@@@@@@ | @@@@@@
 @@@@@@@@  @@@@@@@@@@@@  @@@@@@@  @@@@@@@@  @@@@@@@@  @@@@@@  @@@@@@@@@@ | @@@@@@
 @@@@@@@@  @@@@@@@@@@@@  @@@@@@@  @@@@@@@@  @@@@@@@@  @@@@@@  @@@@@@@@@@ | @@@@@@
 @@@@@@@@  @@@@@@@@@@@@  @@@@@@@  @@@@@@@@  @@@@@@@@  @@@@@@  @@@@@@@@@@ | @@@@@@
 @@@@@@@@  @@@@@@@@@@@@  @@@@@@@  @@@@@@@@  @@@@@@@@  @@@@@@  @@@@@@@@@@ | @@@@@@
 @@@@@@@@  @@@@@@@@@@@@  @@@@@@@  @@@@@@@@  @@@@@@@@  @@@@@@  @@@@@@@@@@ | @@@@@@
 --------------------------------------------------------------------------------
 NEXT-PAGE : __  (+, -, ++, --, E)
 @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

Key:

Column                            

Values                        

Meaning

OWNER-ID


Owner ID of the archive to be displayed

ARCHIVE-NAME


Name of the archive whose tape processing parameters are to be displayed

RQ-TYPE


Type of access whose values are to be displayed

READ

  • Read request

WRITE

  • Write request

EXPRESS

  • Express request (HSMS administrator only)

CONTROL


Tape processing control

STD

  • HSMS parameter definition applies

PROCESS

  • Tape access is possible at any time

HOLD

  • Tape access is placed on hold

SESSIONS

  • Tape access takes place during tape sessions.

START-T.


Time at which the first tape session begins

PERIOD


Period between two tape sessions

MIN.-PAGES


Minimum number of 2-Kbyte blocks to be written during a tape session (only for RQ-TYPE=*WRITE and CONTROL=*SESSIONS)

#REQ


Number of requests

Output in S variables

All variables are of the data type string.

Name of the S variable                                                   

Content                         

Footnote

var(*LIST).ARCHIVE-NAME

<string_1..22>


var(*LIST).READ-CONTR.STA

*STD
*PROC-REQ
*HOLD-REQ
*BY-TAPE-SESSION


var(*LIST).READ-CONTR.START-TIME

*IMMED
<string_8..8>

2)
2)

var(*LIST).READ-CONTR.PERIOD

*END-OF-DAY
1..1440

2)
1) 2)

var(*LIST).READ-CONTR.NUM-OF-REQ

<integer>

1)

var(*LIST).WRITE-CONTR.STA

*STD
*PROC-REQ
*HOLD-REQ
*BY-TAPE-SESSION


var(*LIST).WRITE-CONTR.START-TIME

*IMMED
<string_8..8>

3)
3)

var(*LIST).WRITE-CONTR.PERIOD

*END-OF-DAY
1..1440

3)
1) 3)

var(*LIST).WRITE-CONTR.MIN-PAGE

*NONE
<integer>

3)
1)

var(*LIST).WRITE-CONTR.NUM-OF-REQ

<integer>

1)

var(*LIST).EXPRESS-CONTR.STA

*STD
*PROC-REQ
*HOLD-REQ
*BY-TAPE-SESSION


var(*LIST).EXPRESS-CONTR.START-TIME

*IMMED
<string_8..8>

4)
1) 4)

var(*LIST).EXPRESS-CONTR.PERIOD

*END-OF-DAY
1..1440

4)
1) 4)

var(*LIST).EXPRESS-CONTR.NUM-OF-REQ

<integer>

1)

1)

The integer values are output in string format.

2)

Useable output only if READ-CONTR.STA=*BY-TAPE-SESSION; otherwise output with blank character string

3)

Useable output only if WRITE-CONTR.STA=*BY-TAPE-SESSION; otherwise output with blank character string

4)

Useable output only if EXPRESS-CONTR.STA=*BY-TAPE-SESSION; otherwise output with blank character string

For more detailed information on S variables, refer to the manual “Commands” [5].

Powered by Atlassian Confluence and Scroll Viewport.