Janus commands

From m204wiki
Revision as of 18:23, 2 November 2011 by JAL2 (talk | contribs)
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 commands

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.

ADDCAAdds a trusted certifying authority's certificate to a port.
CHARSETSpecifies the default character set.
CLSOCKSpecifies rules to allow a User Language program to access a CLSOCK or DEBUGGERCLIENT port.
CONFIGURATIONDisplays global configuration values.
DEFINEDefines a Janus port.
DEFINEIPGROUPDefines a grouping of IP addresses for web access control.
DEFINEREMOTEDefines a remote server for Janus Open Client, and associates it with a Janus OPENSERV or SDS port.
DEFINEUSGROUPDefines a grouping of user IDs for web access control.
DELCADeletes a trusted certifying authority's certificate from a port.
DELETEDeletes a port definition.
DELETEIPGROUPDeletes a grouping of IP addresses.
DELETEREMOTEDeletes an association between a remote server and a Janus OPENSERV or SDS port.
DELETEUSGROUPDeletes a grouping of user IDs.
DISPLAYDisplays Janus port definitions.
DISPLAYCADisplays the contents of a trusted certifying authority's certificate.
DISPLAYREMOTEDisplays remoter server definitions.
DISPLAYSOCKDisplays CLSOCK, SRVSOCK, DEBUGGERCLIENT, and FTPSERVER port rules.
DISPLAYTRACEDisplays the TRACE settings for a named port.
DISPLAYWEBDisplays WEBSERV port rules.
DISPLAYXTDisplays translate table definitions.
DOMAINSpecifies the domain; used with IBM TCP/IP to resolve unqualified host names.
DRAINPrevents new connections to port and stops port when last connection is closed.
FORCEBreaks all connections to port and stops port when last connection is closed.
FTPSpecifies Janus FTP Server processing rules.
LANGUAGESpecifies default Janus Open Server language.
LIMITSDisplays the Janus connection limits for an Online.
LOADXTLoads or reloads a translate table and, optionally, an entity translate table.
NAMESERVERSpecifies 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.
RELOADReloads the Model 204-to-SQL mappings from the JANCAT file for a Janus Specialty Data Store port.
SRVSOCKSpecifies rules that determine which SRVSOCK connections to allow.
SSLSTATUSDisplays SSL (Secure Sockets Layer) statistics for SSL ports.
STARTMakes a port available for connections.
STATUSDisplays port status.
STATUSCADisplays the status of a trusted certifying authority's certificate.
STATUSREMOTEDisplays status of remote servers.
TCPLOGStores all input and output streams to and from a port.
TRACEChanges trace settings for a port or for specific IP addresses connected to a port.
TSTATUSDisplays thread utilization statistics.
WEBSpecifies Janus Web Server processing rules. The kinds of rules specified are determined by the web rule "type" as shown below.
NOREDIRECTindicates that any request for a URL that matches the specified pattern (the url value) is not to be directed to another URL.
REDIRECTidentifies the URL to which incoming URL requests that match a specified pattern are redirected.
DISALLOWindicates that any request for a URL that matches a specified pattern (the url value) is not allowed access; that is, it is forbidden.
ALLOWindicates 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).
TYPEindicates the mime type of the output produced by the specified URL (url value).
NODEBUGdisallow debugging for the specified URL
DEBUGindicates that requests for a specified URL (the url value) are to be debugged,
ONindicates 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.
SCREENsets 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.
JANUSDEBUGJANUSDEBUG works in conjunction with JANUS WEB DEBUG rules to assist in debugging Janus applications.