NEWSESOPEN (JANUS DEFINE parameter)

NEWSESOPEN list — open files/groups before NEWSESCMD execution

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

This parameter specifies the names of one or more Model 204 files or groups to be opened before any NEWSESCMD commands are executed. To list multiple files or groups, you must separate them by the AND keyword. You can specify individual file open privileges, or allow them to default to X'0221'.

The syntax of each file or group specification is

[FILE | GROUP] name [ [WITH] privs]

If neither the keyword FILE nor GROUP is specified, the NEWSESOPEN looks first for a permanent group to open, then for a file. It does not look for a temporary group, since one cannot yet exist at open time.

The first file or group listed in an OPEN clause is set as the default file or group context for the thread during NEWSESCMD command processing.

Additional NEWSESOPEN processing notes:

• If the NEWSESCMD parameter specifies an INCLUDE command, the included procedure is assumed to come from the first file or group specified in the NEWSESOPEN clause.
• NEWSESOPEN lets you have data files automatically opened for NEWSESCMD processing, which can be especially useful if the NEWSESCMD processing does not run as an APSY subsystem.
• All files and groups are closed at the end of NEWSESCMD processing, whether or not they were opened as a result of a NEWSESOPEN clause.
• If there is no NEWSESCMD clause in a port definition, the files and groups specified by the NEWSESOPEN clause are not opened. Thus, the NEWSESOPEN parameter is essentially useless except in conjunction with the NEWSESCMD parameter.

Examples of some valid NEWSESOPEN clauses:

JANUS DEFINE WEBXXX 80 WEBSERV 20 - NEWSESOPEN CERTPROC AND FILE CERTDATA WITH X'BFFF' - NEWSESCMD WEBLOGIN JANUS DEFINE TELNETSRV 23 SRVSOCK 10 - NEWSESOPEN TELNETP - NEWSESCMD 'INCLUDE TELNETLOGIN'

This parameter is valid for SRVSOCK, WEBSERV, and TNSERV port types.

This parameter is not valid on an FTPSERVER port definition.

See also

• List of Janus commands
• List of JANUS DEFINE parameters