JANUS DEFINE

<section begin="desc" />Define and set characteristics of a Janus port.<section end="desc" />

Overview

The JANUS DEFINE command is used to specify the characteristics of a Janus port. It defines the usage of the named port as one of the following:

• Access by IFDIAL clients
• Open Server or Open Client connections
• Specialty Data Store access
• Web access
• FTP server connections
• Telnet server connections
• Generic Sockets usage -- with the Model 204 online either requesting (CLSOCK) or accepting (SRVSOCK) the connection
• Connection between the Janus Debugger or Sirius Debugger workstation GUI and programs being debugged in Model 204

For any except a CLSOCK or DEBUGGERCLIENT port, this subcommand associates a service with a TCP/IP port number.

Among the characteristics specified by JANUS DEFINE is whether the port will use Secure Sockets Layer (SSL) for encrypted communications.

See JANUS DEFINE for a discussion of when you need to issue the JANUS DEFINE command.

The JANUS DEFINE command syntax is described below.

Syntax

<section begin="syntax" /> JANUS DEFINE portname portnum type maxcon other_parms... <section end="syntax" />

JANUS DEFINE command syntax

Where each of the first four parameters is positional and required:

portname	A 1- to 30-character name by which the port is identified. It is used on other JANUS subcommands, such as JANUS START and JANUS DISPLAY. It is used on the $Sock_Conn function or the Socket object New constructor to name the CLSOCK port defining a connection.
portnum	The TCP/IP port number at which the service is available. portnum is the server port number, and it must be between 1 and 65535, inclusive. This number is used by client applications on the network when they require access to the Model 204 server. The server port number must be unique on the host. Several "well-known" port numbers for various TCP/IP services (for example, 53 for nameserver should be avoided, unless you are implementing that service using Janus Sockets. For CLSOCK and DEBUGGERCLIENT ports, an asterisk (*) is used as the port number, since they are used to create, rather than accept, connections, and these port numbers are not determined until the time of the connection. For WEBSERV ports, 80 is customary for non-secure HTTP and 443 for secure HTTP (SSL); you can, however, use other numbers for WEBSERV ports if required. For FTPSERVER ports, 21 is customary; you can, however, use other numbers for FTPSERVER ports if required.
type	Port type. Valid types are: CLSOCK A Janus Sockets client socket port. If non-system administrator users are to use a CLSOCK port, rules must be provided to allow them to initiate outgoing connections on the port. DEBUGGERCLIENT A Sirius Debugger client socket port. DEBUGGERSERVER A Janus Debugger or Sirius Debugger server socket port. FTPSERVER A Janus FTP Server application. IFDIAL Janus IFDIAL Library applications. OAS Synonym for type SDS. OMNI Synonym for type SDS. OPENSERV Open Server applications; Open Client connections are outward-bound connections on an OPENSERV port. SRVSOCK A Janus Sockets server socket port. SDS A Specialty Data Store port. TNSERV A Janus Telnet Server port. Only available in Sirius Mods Version 6.9 and later. WEBSERV A World Wide Web Server port. For Janus Open Client usage, you must define one or more ports of type SDS or OPENSERV, and you may need to use the MASTER parameter on a port definition. For JANUS server ports, specify SRVSOCK; for JANUS client ports, specify CLSOCK; for JANUS FTP server ports, specify FTPSERVER; for JANUS telnet server ports, specify TNSERV. TNSERV ports require that the system TNDEV parameter be set to indicate what IODEV daemon threads switch to while in full-screen mode for a telnet connection.
maxcon	Maximum number of simultaneous active connections to be allowed on the port. This number must be less than or equal to the number of TCP/IP connections for which the site is licensed. Before Sirius Mods Version 6.8, the maxcon value had to be less than or equal to the number of sdaemons defined to the online, except for non-CLSOCK ports. If you are defining multiple ports for your site, however, the sum of the maxcon connections you define is allowed to be greater than the number for which the site is licensed. In this case, Janus Web Server will automatically prevent any connection that would exceed the site license limit. For Janus Open Client, note that a server-to-server connection requires an extra connection for the site handler. Thus, a single connection to a remote server would use two connections, while 10 connections to a remote server would use 11. Under Sirius Mods Version and later, restrictions on the allowed values for maxcon are no longer present, but licensed thread limits are still enforced at the time a connection is made. You can use the JANUS TSTATUS command (:hdref refid=tstat.) to view the thread usage and connection limits for your port, and you can use the JANUS LIMITS command to view similar information for your Online.
other_parms	A set of blank-delimited parameters that describe the characteristics of and processing to be performed on the port. These parameters are keywords, sometimes followed by values, and they are described individually in the subsections that follow. .el .do They are all optional, except: are not allowed for OPENSERV ports, CMD is required For CLSOCK ports, REMOTE is required For SRVSOCK ports, CMD is required For FTPSERVER ports, OPEN, CMD, NEWSESOPEN, and NEWSESCMD

JANUS DEFINE parameters

ALLOCC	Indicates that input, output and request buffers are to be allocated when a connection is established and are to be freed when the connection is closed.
ANONYMOUS	The ANONYMOUS parameter must be followed by a number maxanon or an asterisk (*):
ANONUSER	ANONUSER may be specified only if ANONYMOUS is also specified.
AUDTERM	This parameter is used to control whether the server thread sends "non-compiler terminal output" to the audit trail.
AUTODONE	This parameter requests Janus Web Server to treat a return to command mode after all port and ON rules CMDs have been processed as an implicit $Web_Done.
AUTOLOAD	This parameter, indicates that the incore copy of Janus tables are to be reloaded at the first request subsequent to a table redefinition.
AUTOON	This parameter requests Janus Web Server to issue an implicit $Web_On before executing the commands specified in a JANUS WEB ON rule.
AUTOSYS
BINARY	This parameter requests Janus Sockets to send and receive strings with $SOCK_ functions or Socket methods using no translation.
BINDADDR	Specifies the IP address to which the port will be bound, if the host (machine) on which Model 204 is running supports multiple IP addresses.
BSIZE	Specifies the size of the TCP/IP input and output buffers.
CHAR	This parameter requests Janus Sockets to translate strings (sent and received with Janus Sockets functions or methods) between the internal representation within Model 204 (EBCDIC) and the character representation used by the remote end of the connection.
CHARSET	Indicates, to the remote host, the character set being used by Janus.
CLIENTSOCKET	This parameter names the client socket port to use to open connections back to the FTP client, if the client requests active file transfers.
CLOSEIMMED	Indicates that if a lost connection is noticed by the Janus PST, the PST should BUMP the Model 204 thread associated with the connection immediately.
CLOSEREAD	CLOSEIMMED (:hdref refid=climm.) indicates that if a lost connection is noticed by the Janus PST, the PST should BUMP the Model 204 thread associated with the connection immediately.
CMD	Specifies the Model 204 commands to be executed after the files and groups specified in the OPEN parameter are opened.
COMPRESS	Indicates the type of compression to be performed on outgoing Janus Web Server data.
CR	Indicates that lines of text data sent to a browser should be separated by the ASCII carriage return character (X'0D').
CRLF	Indicates that lines of text data sent to a browser should be separated by the ASCII carriage return and line feed characters (X'0D0A').
CSSINSP	Indicates whether or not Janus Web Legacy support is to insert a space to represent the attribute byte on a 3270 screen.
CSSTITLEDIV and CSSTITLESPAN	Indicates whether or not Janus Web Legacy support is to use a <div> (CSSTITLEDIV) or <span> (CSSTITLESPAN) tag for the title line of a screen.
DBCS and NODBCS	Indicates whether or not the Model 204 DBCS parameter is to be automatically set to 1 on requests to a WEBSERV port.
DEBPORTCMD and NODEBPORTCMD	Indicates whether the commands specified in the CMD clause of the JANUS DEFINE command are to be run on threads debugging requests to the port with the JANUSDEBUG command
DEBPORTOPEN and NODEBPORTOPEN	Indicates whether the files and groups specified in the OPEN clause of the JANUS DEFINE command are to be opened on threads debugging requests.
EXEC2RPC	Indicates that language requests should be converted to RPCs.
FDWOL	Specifies that all FINDs done by the Janus Omni are to be done as FIND WITHOUT LOCKS.
FORMPOSTWAIT	The default value for FORMPOSTWAIT is 900.
FORMREDIRWAIT	Since browsers typically respond immediately to a redirect by doing a GET for the target URL without any user interaction, the time between a redirect and the GET should typically be very small.
FINCLOSE	If FINCLOSE is not specified, or if NOFINCLOSE is specified, a Janus Sockets thread remains in-use and does not recognize a FIN indicator sent by a remote partner until the Janus Sockets application tries to receive data on the connection.
HIGHPRIORITY	This parameter adjusts the Model 204 scheduling priority of Janus Web Server threads by starting them at the upper end of their priority range rather than at their default priority.
HTTPVERSION	This parameter sets the HTTP version returned to the browser by Janus Web Server.
IBSIZE	Specifies the size of the TCP/IP input buffer.
INPUTTIMEOUT	This parameter, new as of Sirius Mods Version 6.8, tells Janus Web Server to use a different timeout value for input (receiving the web request) than for output.
JANCAT	Specifies the name of the file that contains the Model 204 to SQL mappings.
KEEPALIVE	The KEEPALIVE parameter indicates the number of seconds a TCP/IP connection is to be held open after an HTTP request on that connection.
LANGUAGE	Indicates, to the remote host, the language being used by Janus.
LEGBL,	This parameter has no effect if an external style sheet is not used (CSS parameter in JANUS WEB SCREEN rules).
LEGCSS and NOLEGCSS	Almost all browsers correctly support the CSS used by
LEGJS and NOLEGJS	While almost all browsers correctly support the simple :hp1.JavaScript:ehp1. used by Janus Web Legacy support, and this :hp1.JavaScript:ehp1. makes the pages generated by Janus Web Legacy support considerably more "friendly", the NOLEGJS parameter can be specified if a site has rules against the use of JavaScript.
LF	Indicates that lines of text data sent to a browser should be separated by the ASCII line feed character (X'0A- ').
LINEND	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.
LOG	Specifies that all Janus Web Server requests for the port are to be logged to a sequential dataset whose DDNAME is specified by xxxx.
LOGAPPEND	Indicates that the Janus Web Server log dataset for the port is to be opened in APPEND mode.
LOGCLOSET	Indicates how often the Janus Web Server log dataset is to be "closed", that is how often the DSCB is to be updated for the log dataset.
LOGGMT	Indicates that the time stamps in the Janus Web Server log dataset for the port are to be represented as GMT instead of local time.
LOGMSGI	This parameter prevents Janus Web Server from saving Model 204 messages issued during logon for a web user.
MASTER	Specifies that this is the default port for :hp1.outgoing:ehp1.
MAXCURS	Specifies the maximum number of cursors that can be opened for a single Janus Omni connection.
MAXIPSES	Specifies the maximum number of Janus Web Legacy Support sessions maintained per IP address.
MAXREC	Specifies the maximum record length for input records on a Janus IFDIAL port.
MAXSAVE	Specifies the maximum number of compiled SQL requests to save in CCATEMP.
MAXTEMP	Specifies the maximum number of CCATEMP pages allowed to be used by a web request for holding input (file upload) and output (dynamically generated HTML) data.
MSGSEND and NOMSGSEND	These parameters are available in Sirius Mods Version 6.0 and later.
MSG204	Specifies the Sybase message number to be used to return terminal output to the client.
MSG204L	Specifies the Sybase message number to be used to return terminal output to the client.
NEWPASSWORDC	This parameter prevents Janus Web Server from immediately sending an "Unauthorized" response to a browser after a password change.
NEWSESCMD	Specifies the Model 204 commands to be executed when a new login session is initiated.
NEWGUESTOK	Indicates that "guest" logins are to be allowed for $Sir_Login calls in programs run as part of NEWSESCMD processing (:hdref refid=newsesc.).
NEWSESNOCLEARG	Indicates that GTBL is not to be cleared at the end of NEWSESCMD command processing.
NEWSESOPEN	Specifies the names of one or more Model 204 files or groups to be opened before any NEWSESCMD commands are executed.
NOAUDTERM	This parameter is used to control whether the server thread sends "non-compiler terminal output" to the audit trail.
NOAUTODONE	This parameter prevents Janus Web Server from treating a return to command mode after all port and ON rules CMDs have been processed as an implicit $Web_Done.
NOAUTOON	This parameter prevents Janus Web Server from preceding the execution of the command specified in a JANUS WEB ON rule with an implicit $Web_On.
NOSCREENREDIR	Indicates that Janus Web Server legacy support (automatic mapping of 3270 applications to HTML) is not to use the redirect's to map all screens for a legacy session to the same URL.
NOTRACEFIELD	Indicates the form field or fields whose values are not to be traced when the X'04' bit (causes tracing of form field values for web requests) of JANUS TRACE is in effect.
NOUPCASE	Indicates that no client data is to be converted to upper case.
OBSIZE	Specifies the size of the TCP/IP output buffer.
OMNIACCT	Specifies the Model 204 ACCOUNT for the SDS catalog sdaemon for the port.
OMNIUSER	Specifies the Model 204 user ID for the SDS catalog sdaemon for the port.
OPEN	Specifies the name of one or more Model 204 files or groups to be opened when a server session is initiated.
PASVPORT	Identifies the first FTP server port number to use for “passive” file transfers.
PRELOGINUSER	Indicates the userid under which pre-login processing runs.
PRSTOK	Specifies the hex values of strings that are used to separate input strings using the $SOCK_RECVPRS function.
PUBLOG	Indicates that a "real" login should be done for the SOCKUSER userid for SRVSOCK logons.
RAWINPUT	Tells Janus Web Server to save the raw input stream for an HTTP POST, regardless of the mime type set by the client in the content-type header.
RAWINPUTONLY
RBSIZE	Specifies the Janus RPC or Request buffer size.
REMOTE	Identifies the remote server and the remote port number to be used with a set of &JSOK CLSOCK connections.
RPCONLY	Indicates that only RPC requests are allowed on the port.
SCREEN and NOSCREEN	The SCREEN and NOSCREEN parameters are available in &SIRMODS. &vsn. 6.3 and later.
SCREENURL	This parameter is available in &SIRMODS. 6.3 and later.
SDSACCT
SDSUSER
SESCOOKIE	Available in &SIRMODS. &vsn. 6.0 and later, SESCOOKIEs are cryptographically designed to be virtually impossible to "fake".
SESCOOKIENOSEC	The SESCOOKIENOSEC parameter is only available in &SIRMODS. &vsn. 6.0 and later.
SESFASTLOGIN	This parameter reduces the login security overhead for &JWEBS threads by causing a login performed for a continued session to be a "fast" login.
SESTIMEOUT	Valid only for WEBSERV ports.
SLOWCLOSE	This parameter is useful for dealing with a bug in some browsers that sends an extra, junk, carriage-return and line-feed character after the contents of an HTTP POST.
SOCKACCT	Specifies the default Model 204 account ID used for SRVSOCK logons.
SOCKPMAX	Specifies the maximum number of sockets a user may have connected at any time using the particular &JSOK client port.
SOCKUSER	Specifies the default Model 204 user ID used for SRVSOCK logons.
SQUAREB	SQUAREB must be followed by either of the following:
SSL	Indicates that communications on this port should be encrypted using SSL (Secure Sockets Layer) or TLS (Transport Layer Security) support.
SSLBSIZE	This tuning parameter specifies the size of the input buffer used for reading encrypted data for an SSL port.
SSLCACHE	Specifies the number of entries in virtual storage to be allocated for caching information related to this port's SSL sessions.
SSLCIPH	Limit the stream ciphers (encryption algorithms) that this port offers for SSL connections.
SSLCLCERT and SSLCLCERTR	Specify that an SSL server port will request an SSL certificate from the client.
SSLIBSIZE	Specifies the size of the SSL input buffer to be used on SSL ports.
SSLMAXAGE	Specifies the maximum number of minutes that an SSL session is to be maintained.
SSLMAXCERTL	Indicates the number of bytes of virtual storage to be allocated to hold incoming certificates presented for authentication.
SSLOBSIZE	Specifies the size of the SSL output buffer to be used on SSL ports.
SSLOPT	Specifies that the use of SSL-like encryption is optional for applications using the port.
SSLPROT	During the negotiation for a connection to or from this port, Janus will offer the most secure protocol available, then, if necessary, will fall back to the next lower one available, and so on.
SSLSES	This feature reduces the overhead of NEWSESCMD processing by limiting it to logical session establishment time.
SSLUNENC	Indicates that an unencrypted private key is being used in the certificate specified by the SSL parameter (:hdref refid=ssl.) on this Janus server port definition.
STIMEOUT
TCPLOG	A new Janus Web Server port definition parameter, TCPLOG, tells Janus Web Server
TCPKEEPALIVE	Specifies that connections on the port should use TCP keepalives.
TIMEOUT	Specifies the number of seconds of inactivity after which clients connected to this port will be disconnected.
TRACE	Specifies the initial TRACE setting for the port.
UPCASE	Indicates that all client "names" are to be converted to upper case.
VARIPADDR	Valid only for WEBSERV ports.
WEBACCT	Specifies the default Model 204 account ID used for web logons for URLs where no userid is required.
WEBCOOKID	Indicates that an identifying "cookie" should be sent to a browser to distinguish multiple browsers coming through the same proxy server or running on the same machine.
WEBLH	Synonym for WEBLOGHOLD; see :hdref refid=wlogh..
WEBLM	Synonym for WEBLOGMAX; see :hdref refid=wlogm..
WEBLOGCOOKIE	Indicates that, for public URLs, Janus Web should log the user in with the userid specified by cookie-name. Normally, all public URL logins use the default public userid (usually WEBUSER).
WEBLOGHOLD	Indicates that number of seconds that a "real" login should be saved for re-use on a web connection.
WEBLOGMAX	Indicates the maximum number of cached login sessions to be held for a single user.
WEBPL	Synonym for WEBPUBLOG; see :hdref refid=wpubl..
WEBPUBLOG	Indicates that a "real" login should be done for the WEBUSER userid for public URLs.
WEBREALM	Indicates the security "realm" of userids and passwords.
WEBSDMAX	Indicates the maximum number of sdaemons to be used for cached web logins.
WEBSM	This parameter is a synonym for WEBSDMAX; see :hdref refid=wsdm..
WEBUSER	Specifies the default Model 204 user ID used for web logons for URLs where no userid is required.
WSFQUERY
XTAB	Specify a translation table that has not yet been loaded with the JANUS LOADXT command, but the table must be loaded before the port can be started.

References

See: List of Janus commands | List of JANUS DEFINE parameters.