Processing the STOP device order
To stop a device that is running under an FSS, JES issues the STOP device order to the FSA' FSI order routine. JES passes the address of the STOP device order parameter list in register 1. The parameter list points to the address response area (IAZRESPA). When the FSI ORDER routine receives the order, it is responsible for determining the type of order issued and either posting the appropriate FSA task to process the order or processing the order directly. The value of the ORDID field in the common order header section of the STOP device order parameter list represents the type of order the FSA needs to process.
- Common parameter header
- Common order header
- STOP order function dependent section
The following figure shows the connection between the different sections of the FSIREQ parameter list for STOP device processing.
The following table shows the parameters that JES initializes for the STOP device order. The values that JES assigns are explained after the table.
| Field Name | Length (bytes) | Value JES Assigned |
|---|---|---|
| Common Parameter Header Section | ||
| FSILEN | 4 | Length of STOP order parameter list |
| FSIFUNC | 4 | FSIORDER |
| FSIFSID | 4 | The FSS/FSA identifier |
| Common Order Header Section | ||
| ORDFDATA | 4 | Information supplied to JES in the FSA CONNECT parameter list (CDFFDATA) |
| ORDRSPAD | 4 | Address of the order response area |
| ORDID | 2 | ORDSPDEV |
| STOP Order Function Dependent Section | ||
| ORDSSSP | 4 | 0 |
| ORDSSF1 | 1 | Type of termination requested |
| ORDSSID | 4 | FSA identifier of device to stop |
| ORDSSAD4 | 4 | Device address in 4-digit format |
| ORDSSAD | 3 | Device address in 3-digit format |
| ORDSSNA | 8 | Device name |
- FSILEN
- The total length of the STOP order parameter list. The STOP order parameter list is composed of the common parameter header, the common order header and the STOP order function dependent section.
- FSIFUNC
- The ORDER ID number. JES assigns the symbolic value FSIORDER to this field.
- FSIFSID
- The FSS/FSA identifier that JES assigned when it started the FSS and FSA.
- ORDFDATA
- The address of a control block containing FSA-related information. The FSA supplied this address to JES in the CDFFDATA field of the CONNECT parameter list. JES returns this value in the STOP device order parameter list so that the FSA's FSI ORDER routine can activate the appropriate FSA task to process the order.
- ORDRSPAD
- The address of the order response area (IAZRESPA).
- ORDID
- The STOP device order ID number. JES assigns the symbolic value ORDSPDEV to this field.
- ORDSSSP
- This field is set to zero. JES supplies the address of the device initialization area in this field for the START FSA order only.
- ORDSSF1
- This flag byte indicates the type of device termination requested
by JES.
- ORDSSNO B‘10000000’
- The FSA is to terminate the device normally.
- ORDSSAB B‘01000000’
- The FSA is to abnormally terminate the device.
- ORDSSDU B‘00001000’
- The FSA is to take a dump when the device terminates.
- ORDSSID
- The FSA identifier of the device to stop.
- ORDSSSI
- The FSS section of the FSA identifier.
- ORDSSAI
- The FSA section of the FSA identifier.
- ORDSSAD4
- The 4-digit device address in printable form. If the printer is a non-channel attached device, this field will contain blanks.
- ORDSSAD
- The 3-digit device address in printable form. If the printer is a non-channel attached device, this field will contain blanks.
- ORDSSNA
- The device name in printable form.