GDDM V3R2 Base Application Programming Reference
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF | BOOK


FSLOG

GDDM V3R2 Base Application Programming Reference
SC33-0868-02



Function


To send character string to alternate device.


   FSLOG       (length, string)

APL code 603 GDDM RCP code X'0C180003' (202899459)


Parameters


length (specified by user) (fullword integer)
The length of string. The maximum length is as defined (or defaulted) on the FSOPEN or DSOPEN statement, the default for which is 80. Specifying length=0 leaves a blank line in the output.


string (specified by user) (character)
The string of EBCDIC characters to be sent.

SO/SI (shift-out/shift-in) control-code characters can be included in the string and are sent to the device as "passthrough"; that is, they are not processed in any way. A mixed string of single and double-byte characters can, therefore, be presented, provided the alternate device supports SO/SI control codes as a delimiter of mixed strings, and the SO/SI control codes are correctly paired in the string. Neither of these conditions are checked by GDDM.

Description


Sends (copies) the specified string to the currently open family-1, family-2, family-3, or family-4 cell-based alternate device.

FSLOG calls can be mixed with FSLOGC, FSCOPY, and GSCOPY calls within a single open-close session. Consecutive FSLOG and FSLOGC data is batched together and sent separately from any FSCOPY and GSCOPY output.

Note: The FSLOG call does not require a primary device to be available, and so does not cause a default one to be set up.

Principal errors


ADM0070 E
NO ALTERNATE DEVICE
ADM0282 E
INVALID LOG DATA LENGTH

Go to the previous page Go to the next page



Copyright IBM Corporation 1990, 2012