Janus commands

The Janus command set (simply referred to as "Janus commands") consists of commands and subcommands that begin with the string JAN. The two Janus commands currently supported are JANUS and JANUSDEBUG.

You use Janus commands to:

• Define Model 204 as a server on the TCP/IP network. Janus commands set port numbers for your Janus server applications and start, stop, and monitor Janus activity in the Model 204 address space.
• Define remote servers to the Model 204 client for access by Janus Open Client applications and Janus Sockets client applications, and define which remote hosts can establish connections with Janus Specialty Data Store, Janus Open Server, and Janus Sockets.
• Add security to Janus ports using Secure Sockets Layer (SSL) or Transport Layer Security (TLS) to provide encrypted communications.
• Define server rules (like redirection or security filtering for specific data types, users, or TCP/IP addresses) for Janus Web Server and Janus Sockets applications.
• Perform interactive, terminal-based debugging of Janus Web Server applications (using the JANUSDEBUG command).

Janus commands require the executing user to have System Manager privileges. The JANUSDEBUG command, which can be issued by any logged-in user, is an exception. Janus commands can also be issued as operator commands (on the Online virtual console under VM) or as replies to the HALT message under OS/390.

Janus commands make use of the following wildcard characters:

*	An asterisk represents any string of characters.
?	A question mark represents any character.
"	A double quote escapes wildcard translation of the special character that follows it.

For example, the following command starts all Janus ports whose names begin with the string BA (like BART, BARNEY, BALES, BAY):

JANUS START BA*

The following command drains all Janus ports whose names are three characters long, beginning with BA (BAY, BAD, BAX, etc.):

JANUS DRAIN BA?

The following command starts all Janus ports whose names end in ? (WHODONEIT?, WHERES_THE_BEEF?, WHAT?_ME_WORRY?, WHO_YA_GONNA_CALL?, etc.):

JANUS START *"?

List of JANUS subcommands

The principal command of the Janus command set is the JANUS command, which consists of a set of mutually exclusive subcommands. To execute a subcommand, you specify it with the prefix JANUS: for example, JANUS DEFINE, JANUS STATUS.

The following list shows the JANUS subcommands with a brief description of what they do.

ADDCA	Adds a trusted certifying authority's certificate to a port.
ADDCOORDINATOR	Adds a two-phase commit coordinator to a port.
CHARSET	Specifies the default character set.
CLSOCK	Specifies rules to allow a User Language program to access a CLSOCK or DEBUGGERCLIENT port.
CONFIGURATION	Displays global configuration values.
DEFINE	Defines a Janus port.
DEFINEIPGROUP	Defines a grouping of IP addresses for web access control.
DEFINEREMOTE	Defines a remote server for Janus Open Client, and associates it with a Janus OPENSERV or SDS port.
DEFINEUSGROUP	Defines a grouping of user IDs for web access control.
DELCA	Deletes a trusted certifying authority's certificate from a port.
DELETE	Deletes a port definition.
DELETECOORDINATOR	Deletes a two-phase commit coordinator from a port.
DELETEIPGROUP	Deletes a grouping of IP addresses.
DELETEREMOTE	Deletes an association between a remote server and a Janus OPENSERV or SDS port.
DELETEUSGROUP	Deletes a grouping of user IDs.
DISPLAY	Displays Janus port definitions.
DISPLAYCA DISCA	Displays the contents of a trusted certifying authority's certificate.
DISPLAYCOORDINATOR DISCOORDINATOR	Displays two-phase commit coordinator definitions for a port.
DISPLAYIPGROUP DISPLAYIPG DISIPGROUP DISIPG	Displays IP group definitions.
DISPLAYREMOTE DISPLAYREM DISREMOTE DISREM	Displays remoter server definitions.
DISPLAYSOCK DISSOCK	Displays CLSOCK, SRVSOCK, DEBUGGERCLIENT, and FTPSERVER port rules.
DISPLAYTRACE DISTRACE	Displays the TRACE settings for a named port.
DISPLAYWEB DISWEB	Displays WEBSERV port rules.
DISPXT	Displays translate table definitions.
DOMAIN	Specifies the domain; used with IBM TCP/IP to resolve unqualified host names.
DRAIN	Prevents new connections to port and stops port when last connection is closed.
FORCE	Breaks all connections to port and stops port when last connection is closed.
FTP	Specifies Janus FTP Server processing rules.
LANGUAGE	Specifies default Janus Open Server language.
LIMITS	Displays the Janus connection limits for an Online.
LOADXT	Loads or reloads a translate table and, optionally, an entity translate table.
NAMESERVER	Specifies IP address and port number of the domain name server used with Janus Sockets CLSOCK applications and Janus Open Client applications; only used with the IBM TCP/IP interfaces.
RELOAD	Reloads the Model 204-to-SQL mappings from the JANCAT file for a Janus Specialty Data Store port.
SRVSOCK	Specifies rules that determine which SRVSOCK connections to allow.
SSLSTATUS	Displays SSL (Secure Sockets Layer) statistics for SSL ports.
START	Makes a port available for connections.
STATUS	Displays port status.
STATUSCA	Displays the status of a trusted certifying authority's certificate.
STATUSREMOTE	Displays status of remote servers.
TCPLOG	Stores all input and output streams to and from a port.
TRACE	Changes trace settings for a port or for specific IP addresses connected to a port.
TSTATUS	Displays thread utilization statistics.
WEB	Specifies Janus Web Server processing rules. The kinds of rules specified are determined by the web rule "type" as shown below. NOREDIRECT indicates that any request for a URL that matches the specified pattern (the url value) is not to be directed to another URL. REDIRECT identifies the URL to which incoming URL requests that match a specified pattern are redirected. DISALLOW indicates that any request for a URL that matches a specified pattern (the url value) is not allowed access; that is, it is forbidden. ALLOW indicates that a request from a particular user or set of users can have access to any URL that matches a specified pattern (the url value). TYPE indicates the mime type of the output produced by the specified URL (url value). NODEBUG disallow debugging for the specified URL. DEBUG indicates that requests for a specified URL (the url value) are to be debugged. ON indicates the action to be taken when a request for a specified URL (the url value), which is not redirected, is determined to be allowed access. SCREEN sets parameters that control the mapping of 3270 screens to HTML, for Janus Web Legacy Support, for example.
The JANUSDEBUG command is not a subcommand of JANUS, but stands on its own.
JANUSDEBUG	JANUSDEBUG works in conjunction with JANUS WEB DEBUG rules to assist in debugging Janus applications.

See also

• List of Janus Web Server $functions