The FICON® Switch Data macro service is used to obtain statistical counters from FICON switch devices.
The requirements for the caller are:
Environmental factor | Requirement |
---|---|
Minimum authorization: | Problem or Supervisor state or any PSW key. |
Dispatchable unit mode: | Task |
Cross memory mode: | PASN=HASN=SASN |
AMODE: | 31-bit addressing mode. |
ASC mode: | Primary |
Interrupt status: | Enabled for I/O and external interrupts |
Locks: | No locks held. |
Control parameters: | Control parameters must be in the primary address space. |
None
Before issuing the IRDFSD macro, the caller does not have to place any information into any register unless using it in register notation for a particular parameter, or using it as a base register.
Some callers depend on register contents remaining the same before and after issuing a service. If the system changes the contents of registers on which the caller depends, the caller must save them before issuing the service, and restore them after the system returns control.
None.
The IRDFSD macro is written as follows:
Syntax | Description |
---|---|
name | name: Symbol. Begin name in column 1. |
␢ | One or more blanks must precede IRDFSD. |
IRDFSD | |
␢ | One or more blanks must follow IRDFSD. |
DEVICE=ALL | Default: DEVICE=ALL |
DEVICE=SINGLE | |
,DEVICENUMBER=devicenumber | Required with DEVICE=SINGLE |
,COUNTERS=DEFAULT | Default: COUNTERS=DEFAULT |
COUNTERS=ALL | |
COUNTERS=LIST | |
,COUNTERLIST=counterlist | Required with COUNTER=LIST |
SUBPOOL=0 | Default: SUBPOOL=0 |
SUBPOOL=subpool | |
FSDADDRESS=fsdaddress | |
FSDLENGTH=fsdlength | |
,RETCODE=retcode | retcode: RS-type address or register (2) - (12). |
,RSNCODE=rsncode | rsncode: RS-type address or register (2) - (12). |
,PLISTVER=IMPLIED_VERSION | Default: PLISTVER=IMPLIED_VERSION |
,PLISTVER=MAX | |
,PLISTVER=1 | |
,MF=S | Default: MF=S |
,MF=(L,mfctrl) | list addr: RS-type address or register (1) - (12). |
,MF=(L,) | |
,MF=(L,r,0D) | |
,MF=(E,) | |
,MF=(E,) | |
,MF=(E,) | |
The parameters are explained as follows:
To code: Specify the RS-type address or address in register (2)-(12), of a 4 byte field.
To code: Specify the RS-type address or address in register (2)-(12), of a 4 byte field.
The number of Control Words cannot exceed 60.
See the IHAFSD macro for further information about the definition of the statistical counter list (SCCW) and the counters available.
To code: Specify the RS-type address or address in register (2)-(12) of the 1 byte field containing the subpool.
The returned information is mapped in macro IHAFSD.
The mapping macro IHAFSD can be found in SYS1.MODGEN.
To code: Specify the RS-type address of a fullword field, or register (2)-(12).
To code: Specify the RS-type address of a 4-byte field, or register (2)-(12).
To code: Specify the RS-type address of a fullword field, or register (2)-(12).
To code: Specify the RS-type address of a fullword field, or register (2)-(12).
If you can tolerate the size change, IBM® suggests that you always specify PLISTVER=MAX on the list form of the macro. Specifying MAX ensures that the list-form parameter list is always long enough to hold all the parameters you might specify on the execute form, when both are assembled with the same level of the system. In this way, MAX ensures that the parameter list does not overwrite nearby storage.
Use MF=S to specify the standard form of the macro, which builds an inline parameter list and generates the macro invocation to transfer control to the service. MF=S is the default.
Use MF=L to specify the list form of the macro. The list form defines an area of storage that the execute form uses to store the parameters. Only the PLISTVER parameter can be coded with the list form of the macro.
Use MF=E to specify the execute form of the macro. The execute form of the macro stores the parameters into the storage area defined by xmfctrl and provides full syntax checking with the default setting.
None.
The following table identifies the hexadecimal return codes:
Hexadecimal Return Code | Meaning |
---|---|
00 | Meaning: Successful completion. Data returned for all FICON switches. |
04 | Meaning: No FICON switch devices found. No FSD area was obtained. |
08 | Meaning: I/O errors occurred. Some switches did not return data. |
0C | Meaning: I/O errors occurred. No data obtained for any devices. |
10 | Meaning: Unexpected error. |
The following table identifies the hexadecimal return and reason codes:
Hexadecimal Return Code | Return Code | Meaning |
---|---|---|
00000001 | 04 | Required module unavailable. The request could not be processed. |
00000002 | 04 | The server task is not active. The request could not be processed. |
00000024 | 04 | FICON switch statistics disabled. |
00000003 | 08 | Caller is not APF authorized. |
00000008 | 08 | IRDVFSD does not recognize the request type. |
00000021 | 08 | Specified device is not a FICON switch. |
00000022 | 08 | Specified device is not online. |
00000023 | 08 | IOSVFSD does not recognize the request type. |
00000004 | 0C | Recovery could not be established. |
00000005 | 0C | POST failed. |
00000006 | 0C | Recovery was entered. |
00000025 | 0C | I/O error. |
00000026 | 0C | UCBSCAN failure. |
00000027 | 0C | UCBLOOK failure. |
00000028 | 0C | Server task recovery entered. |