FSOPEN

GDDM V3R2 Base Application Programming Reference

FSOPEN

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Function

Note: This call is not recommended for new programs. It is obsolete and has been superseded by DSOPEN.

To open alternate device.


   FSOPEN      (destination, count, array)

   APL code               604
   GDDM RCP code          X'0C180000' (202899456)

Parameters

destination (specified by user) (8-byte character string)
The alternate device destination as an eight-character string (left-justified). The interpretation of the string depends on the subsystem, and is as described under DSOPEN for the first element of name-list.

count (specified by user) (fullword integer)
The number of fullwords in array. It may be zero if all of the print options are to be defaulted.

array (specified by user) (an array of fullword integers)
An array with a maximum significant length of nine fullwords. If the first fullword is present, it is the parameter content type, and must be zero. The remaining fullwords, if present, comprise up to eight print-control processing options (option-group 4), from the heading indicator to the alphanumeric device type for translation. These are described under DSOPEN.

If fewer than the maximum number of words are supplied, the remainder are assigned default values.

Description

Initializes output to the specified family-2 alternate device. GDDM automatically opens a queued printer (family 2) device, with a device identifier of 1, a default device token '* ', the specified destination as the only element in the name list, and processing options containing the specified array in the print control option group (4). It also automatically makes this the alternate device.

FSOPEN is retained for compatibility. It is a Version 1 Release 1 call whose functions have been duplicated and extended by DSOPEN.

Principal errors

ADM0071 E: INVALID PARAMETER COUNT
ADM0072 E: INVALID PARAMETER CONTENT TYPE
ADM0073 E: ALTERNATE DEVICE ALREADY OPEN
ADM0077 E: DEVICE ALREADY EXISTS
ADM0281 E: INVALID PARAMETER ARRAY. REASON CODE n

Notices | Terms of use | Support | Contact z/OS