LINEND (JANUS DEFINE parameter): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
(Automatically generated page update)
 
(16 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:LINEND}}
<span class="pageSubtitle">LINEND [hexstr | NONE] &mdash; set or disable line-end character for socket port</span>
<span class="pageSubtitle"><section begin="desc" />LINEND [hexstr | NONE] -- set or disable line-end character for socket port.<section end="desc" /></span>


LINEND is a parameter on [[JANUS DEFINE]], which defines and sets characteristics of a Janus port. See the [[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]].
<var>LINEND</var> is a parameter on <var>[[JANUS DEFINE]]</var>, which defines and sets characteristics of a Janus port.  


This parameter specifies the hex value of a string to be sent by ''[[Janus Sockets]]'' at the end of each "line;" that is, appended to the string sent by the $SOCK_SENDLN functions or after each output line captured on the socket.  
This parameter specifies the hex value of a string to be sent by <var class="product">[[Janus Sockets]]</var> at the end of each "line;" that is, appended to the string sent by the <var>[[$Sock_SendLn]]</var> functions or after each output line captured on the socket.  


The default is LINEND 0D; 0D is the hexadecimal representation of the carriage return, both in EBCDIC and in ASCII.  
The default is <code>LINEND 0D</code>; <code>0D</code> is the hexadecimal representation of the carriage return, both in EBCDIC and in ASCII.  


You can specify LINEND NONE, which means that a LINEND value must be set with $SOCK_SET before the $SOCK_SENDLN function is called.  
You can specify <code>LINEND NONE</code>, which means that a <var>LINEND</var> value must be set with <var>[[$Sock_Set]]</var> before the <var>$Sock_SendLn</var> function is called.  


Note that the specified string is sent untranslated, regardless of the CHAR or BINARY setting of the socket. For example, the following specifies that the byte pair which is ASCII carriage return and linefeed should be appended to each $SOCK_SENDLN call or User Language print line:
Note that the specified string is sent untranslated, regardless of the <var>[[CHAR (JANUS DEFINE parameter)|CHAR]]</var> or <var>[[BINARY (JANUS DEFINE parameter)|BINARY]]</var> setting of the socket. For example, the following defines an SSL-protected, client socket port; it specifies that the byte pair which is ASCII carriage return and linefeed should be appended to each <var>$Sock_SendLn</var> call or <var class="product">User Language</var> <var>Print</var> line:


<p class="code"> JANUS DEFINE CLMASTER * CLSOCK 5 TIMEOUT 240 REMOTE * * MASTER SSL 0 SSLOPT -
<p class="code">JANUS DEFINE CLMASTER * CLSOCK 5 TIMEOUT 240 REMOTE * * MASTER SSL 0 SSLOPT -
            SSLMAXCERTL 4096 SSLBSIZE 32767 LINEND 0D0A
            SSLMAXCERTL 4096 SSLBSIZE 32767 LINEND 0D0A
</p>
</p>
<p class="caption">An SSL-protected, client socket port with LINEND specified.</p>


The LINEND value for a socket can be changed using $SOCK_SET.  
The <var>LINEND</var> value for a socket can be changed using <var>$Sock_Set</var>.  


Valid only for CLSOCK and SRVSOCK ports.
Valid only for <var>[[JANUS DEFINE#type|CLSOCK]]</var> and <var>[[JANUS DEFINE#type|SRVSOCK]]</var> ports.


==References==
==See also==
<ul>
<li>[[List of Janus commands]]
<li>[[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]]
</ul>


See: [[List of Janus commands]] | [[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]].


[[Category:JANUS DEFINE parameters|LINEND]]
[[Category:JANUS DEFINE parameters|LINEND]]

Latest revision as of 22:18, 16 April 2013

LINEND [hexstr | NONE] — set or disable line-end character for socket port

LINEND is a parameter on JANUS DEFINE, which defines and sets characteristics of a Janus port.

This parameter specifies the hex value of a string to be sent by Janus Sockets at the end of each "line;" that is, appended to the string sent by the $Sock_SendLn functions or after each output line captured on the socket.

The default is LINEND 0D; 0D is the hexadecimal representation of the carriage return, both in EBCDIC and in ASCII.

You can specify LINEND NONE, which means that a LINEND value must be set with $Sock_Set before the $Sock_SendLn function is called.

Note that the specified string is sent untranslated, regardless of the CHAR or BINARY setting of the socket. For example, the following defines an SSL-protected, client socket port; it specifies that the byte pair which is ASCII carriage return and linefeed should be appended to each $Sock_SendLn call or User Language Print line:

JANUS DEFINE CLMASTER * CLSOCK 5 TIMEOUT 240 REMOTE * * MASTER SSL 0 SSLOPT - SSLMAXCERTL 4096 SSLBSIZE 32767 LINEND 0D0A

The LINEND value for a socket can be changed using $Sock_Set.

Valid only for CLSOCK and SRVSOCK ports.

See also