The FICON® Switch Data macro update service is used to update 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 IRDFSDU 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 IRDFSDU macro is written as follows:
Syntax | Description |
---|---|
name | name: Symbol. Begin name in column 1. |
␢ | One or more blanks must precede IRDFSDU. |
IRDFSDU | |
␢ | One or more blanks must follow IRDFSDU. |
,TOLERANCE=tolerance | toleranceRS-type address or address in register (2) — (12). |
,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) | |
,MF=(L,mfctrl,mfattr) | |
,MF=(L,mfctrl,0D) | |
,MF=(E,mfctrl) | |
,MF=(E,COMPLETE) | |
The parameters are explained as follows:
To code:Specify the RS-type address or address in register (2)-(12), of an 8 byte field.
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® recommends 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 may 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 mfctrl and provides full syntax checking with the default setting.
None.
The following table identifies the hexadecimal return and reason codes:
Hexadecimal Return Code | Hexadecimal Reason Code | Meaning |
---|---|---|
00 | Meaning: Successful completion. Data updated for all FICON switches. |
|
04 | 2 | Warning Meaning: The server task is not available |
04 | 24 | Environmental Error Meaning: FICON switch statistics disabled |
08 | 1 | Meaning: The subpool provided by the caller is not in common storage. |
08 | 2 | Meaning: The switch device provided by the caller is not in the Switch Table. |
20 | 1 | Meaning: An ESTAE could not be established. |
The following table identifies the hexadecimal return and reason codes:
Hexadecimal Return Code | Return Code | Meaning |
---|---|---|
00000001 | 04 | Required module was not found. The request could not be processed. |
00000002 | 04 | The server task is unavailable. 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. |
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. |