Janus commands

From m204wiki
Jump to navigation Jump to search


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 as of Sirius Mods version 6.3 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.
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.
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 Displays the contents of a trusted certifying authority's certificate.
DISPLAYREMOTE Displays remoter server definitions.
DISPLAYSOCK Displays CLSOCK, SRVSOCK, DEBUGGERCLIENT, and FTPSERVER port rules.
DISPLAYTRACE Displays the TRACE settings for a named port.
DISPLAYWEB 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.