FSLOGC

GDDM V3R2 Base Application Programming Reference

FSLOGC

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Function

To send character string with carriage-control character to alternate device.


   FSLOGC      (length, string)

   APL code               606
   GDDM RCP code          X'0C180005' (202899461)

Parameters

length (specified by user) (fullword integer)
The length of string. The maximum length is 1 greater than the length defined (or defaulted) in the FSOPEN or DSOPEN call, the default for which is 80.

string (specified by user) (character)
The string of EBCDIC characters to be sent. The first character is interpreted according to the values in the following table; an invalid carriage-control character is interpreted as X'09'.


Action	CTLASA code carriage-control characters	CTL360 code bytes carriage-control characters
Action	(Action before printing)	(Action after printing)	(Action without printing)
No line	+	X'01'	X'03'
Space 1 line	blank	X'09'	X'0B'
Space 2 lines	0	X'11'	X'13'
Space 3 lines	-	X'19'	X'1B'
Space to new page	1	X'89'	X'8B'

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. The first character of the string is interpreted as a carriage-control character.

Overstriking characters are processed in the following way. If several strings are to be printed on the same line:

The end-result is underscored if an underscore occurs in any string for a specific print position.
The end-result is blank if a blank (or a null character such as end-of-string) occurs in all the strings for a specific print position.
Otherwise, the end-result for a specific print position is the first non-blank character (except underscore) in the strings for that position. For example, if the following two lines were to be printed in the same positions:
```
            A   B
             DC X
```
The line that would be printed would be:
```
            ADC B
```
FSLOGC calls can be mixed with FSLOG, FSCOPY, and GSCOPY calls within a single open-close session. Consecutive FSLOGC and FSLOG data is batched together and sent separately from any FSCOPY and GSCOPY output.

Note: The FSLOGC 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

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