NEWSESOPEN (JANUS DEFINE parameter): Difference between revisions
m (1 revision) |
mNo edit summary |
||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:NEWSESOPEN}} | {{DISPLAYTITLE:NEWSESOPEN}} | ||
<span class="pageSubtitle"><section begin="desc" />list<section end="desc" /></span> | <span class="pageSubtitle"><section begin="desc" />NEWSESOPEN list -- open files/groups before NEWSESCMD execution.<section end="desc" /></span> | ||
NEWSESOPEN is a parameter on [[JANUS DEFINE]], which defines and sets characteristics of a Janus port. See the [[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]]. | NEWSESOPEN is a parameter on [[JANUS DEFINE]], which defines and sets characteristics of a Janus port. See the [[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]]. | ||
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 <code>AND</code> 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 | |||
<p class="code"> [FILE | GROUP] name [ [WITH] privs] | <p class="code"> [FILE | GROUP] name [ [WITH] privs] | ||
</p> | </p> | ||
If neither the keyword <code>FILE</code> nor <code>GROUP</code> 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. | If neither the keyword <code>FILE</code> nor <code>GROUP</code> 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. | ||
| Line 18: | Line 16: | ||
Additional NEWSESOPEN processing notes: | Additional NEWSESOPEN processing notes: | ||
<ul> | <ul> | ||
<li>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. | |||
<li>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. | <li>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. | ||
<li>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. | <li>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. | ||
<li>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. | <li>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. | ||
</ul> | </ul> | ||
Examples of some valid NEWSESOPEN clauses: | Examples of some valid NEWSESOPEN clauses: | ||
| Line 40: | Line 39: | ||
NEWSESOPEN is | NEWSESOPEN is supported in Version 6.0 and later of ''[[Sirius Mods]]''. | ||
This parameter is valid for SRVSOCK, WEBSERV, and TNSERV port types. | This parameter is valid for SRVSOCK, WEBSERV, and TNSERV port types. | ||
Revision as of 14:06, 14 March 2011
<section begin="desc" />NEWSESOPEN list -- open files/groups before NEWSESCMD execution.<section end="desc" />
NEWSESOPEN is a parameter on JANUS DEFINE, which defines and sets characteristics of a Janus port. See the List of JANUS DEFINE parameters.
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'
NEWSESOPEN is supported in Version 6.0 and later of Sirius Mods.
This parameter is valid for SRVSOCK, WEBSERV, and TNSERV port types.
This parameter is not valid on an FTPSERVER port definition.
References
See: List of Janus commands | List of JANUS DEFINE parameters.