Available EPARM Parameters

When using the ASCXONE routine, you can specify parameters in the EPARM value on the PARM configuration statement or on the RSCS DEFINE or START command.
Notes:
  1. Because the EPARM parameter is limited to 239 bytes, these options may be useful only for small amounts of data.
  2. Any command received through the CP SMSG facility or the RSCS console will be truncated at 132 bytes.
The following parameters are supported:
Sep=
specifies whether a separator page will be printed for each file.
Yes
Prints a separator page. This is the default. The origin user ID and node ID and distribution information are printed in large characters; other file information is printed in small characters in the Times-Bold font.
No
Does not print a separator page.
2p
Produces a two-page separator page. This is useful with duplexing so that the print data starts on a fresh page.
FF=
specifies how printer form-feeds are performed.
TOP
Form-feed is sent in the front of the file.
Bottom
Form-feed is sent after the file; this is the default.
None
Form-feed is not sent.
Prefix=hex_string
optionally specifies a hexadecimal string to be sent in front of each file; this string is not translated. Up to 200 bytes of data can be specified.

The prefix string can be split with part sent before the separator page and part sent after. The string will be split if the X'FF04' divider characters are detected within the prefix string. The part before the divider characters will be sent prior to the separator page with the remaining sent after.

SUFfix=hex_string
optionally specifies a hexadecimal string to be sent after each file; the string is not translated. Up to 200 bytes of data can be specified.
Initial=hex_string
optionally specifies a hexadecimal string that is sent when the link initializes; the string is not translated. By default, an initial string is not sent. Up to 200 bytes of data can be specified.
Config=ddname
specifies the ddname which has been defined as an exit configuration file. If the ddname does not exist, the ASCXONE exit will pass back a return code to cause the TCPASCII-type link to issue an error message and drain. If this exit parameter is not used, a configuration file is not read by the exit, causing existing defaults to be used for values which can be defined by the configuration file. For more information, see ASCXONE Configuration file.
CONVert=No
CONVert=Yes
specifies whether to allow protocol conversion. The default is CONVERT=NO. This function has been added for printers moved from coax connected protocol converters to LAN attached, connected to multiprotocol cards for TCP/IP. Some applications use the functions built in to protocol converters.

The ASCXONE exit will look for strings starting with a header defined by the PCL exit parameter and ending with a trailing X'4A' character, which surround pairs of bytes that spell out PCL commands. These pairs of bytes will be packed into single bytes that are the equivalent PCL bytes, which are already in ASCII. Multiple PCL strings can be contained in each record of the print file as long as each string contains the X'4A' trailing character.

In addition, the ASCXONE exit will look for the SCS (SNA Character String) transparency strings contained anywhere within each record. The SCS transparency string is defined with a X'35' followed by a one byte length, followed by data for the defined length that is sent unaltered (not translated). Multiple SCS transparency strings can be contained within a single record.

PCL=hex_string
specifies a 2- to 8-character hexadecimal string which defines the header for PCL strings. When the CONVERT=YES exit parameter is specified, the ASCXONE exit will search for this string in each record of the file to be printed. An even number of characters must be specified; the default is 6A79.