Show file name associated with specified block
Component: | BS2000 |
Functional area: | System control and optimization |
Domain: | SYSTEM-TUNING |
Privileges: | TSOS |
Function
This command tells systems support the names of the files in which the specified blocks are located. Its primary function is to identify the files which are associated with bad blocks. For files to be consistently associated with disks/blocks, the corresponding pubset must not be subject to CMS or allocator actions. Such conditions apply only during a pubset’s IMCAT phase or in the case of an exclusively imported pubset.
The command supports structured output in S variables (see "Output in S variables").
Format
SHOW-BLOCK-TO-FILE-ASSIGNMENT |
VOLUME = <vsn 1..6> ,BLOCK-NUMBER = list-poss(255): <integer 1..2147483647> |
Operands
VOLUME = <vsn 1..6>
Identifies the disk containing the specified blocks by volume serial number (VSN).
BLOCK-NUMBER = list-poss(255): <integer 1..2147483647>
Identifies the physical half-page number of the required block.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed without error | |
1 | 0 | CMD0001 | K2 interrupt |
32 | CMD2009 | Error on output to S variables (e.g. subsystem not available) | |
32 | DMS05C7 | Internal DMS error | |
64 | CMD0202 | Syntax or semantic error | |
64 | DMS0501 | Requested catalog not available | |
64 | DMS0512 | Requested catalog not found | |
64 | DMS06CC | No file uses the specified block | |
64 | OPS0002 | K2 interrupt on output to S variables | |
130 | OPS0001 | Space problems on output to S variables |
Output in S variables
Output information | Name of the S variable | T | Contents | Condition |
|---|---|---|---|---|
Physical half-page number of a (defective) block which can be associated with a file | var(*LIST).FOUND(*LIST).BLOCK | I | <integer> | |
Name of the file containing the (defective) block | var(*LIST).FOUND(*LIST).F-NAME | S | <path-name> | |
Physical half-page number of a (defective) block which cannot be associated with a file | var(*LIST).NOT-FOUND(*LIST).BLOCK | I | <integer> | |
VSN of the disk on which the (defective) blocks are located | var(*LIST).VOL | S | <vsn> |