Example 3:

Define a 2501 card reader device on device address 000C. The card reader is a socket device accepting
remote connections from address 127.0.0.1 port 2501. The file contains variable length lines of ASCII
characters delimited by line feed or carriage return line feed sequences at the end of each line. Lines
longer than 80 bytes have to be truncated and a unit exception status has to be presented after reading
the last card in the file.

000C 2501 127.0.0.1:2501 SOCKDEV ASCII TRUNC EOF

6.6 Card Punch Devices

6.6.1 Function

The card punch statement defines a card punch device to the Hercules configuration. The argument
specifies the name of the file to which the punched output will be written. Additional arguments may be
specified after the filename.

6.6.2 Syntax

Descriptive

filename

Diagram

Êʬ¬¬ ¬¬¬ ¬¬¬ filename ¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬Ê

ʬ¬¬§¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

6.6.3 Parameter

devaddr

This is the device address.

devtype

This is the device type. A valid card punch type is 3525.

filename

The name (and optionally the path) of the card punch file.

ASCII

ASCII specifies that the file will be written as variable length lines of ASCII charac-
ters, delimited by line feeds or carriage return line feed sequences. Trailing blanks
are removed from each line. If the ASCII argument is not specified, the file is written
as fixed length 80-byte EBCDIC records with no line-end delimiters.

CRLF

This optional parameter specifies that carriage return line feed sequences are writ-
ten at the end of each line. If the CRLF argument is not specified, line feeds are
only written at the end of each line.

NOCLEAR

This argument specifies that the output file will not be cleared to zero bytes when it
is opened. If NOCLEAR is not specified, then any previous content of the file is de-
stroyed when the file is opened for output.