OPEN (JANUS DEFINE parameter): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
Line 2: Line 2:
<span class="pageSubtitle"><section begin="desc" />OPEN list -- files/groups to open on connection to port.<section end="desc" /></span>
<span class="pageSubtitle"><section begin="desc" />OPEN list -- files/groups to open on connection to port.<section end="desc" /></span>


OPEN 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]].
<var>OPEN</var> 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 name of one or more ''Model 204'' files or groups to be opened when a server session is initiated.  
This parameter specifies the name of one or more ''Model 204'' files or groups to be opened when a server session is initiated.  


If you specify multiple files or groups in an OPEN clause, they must be separated by an AND keyword. You can also specify individual file open privileges; if not, they default to X'0221'. Multiple files or groups and explicitly specified privileges in the OPEN clause are supported in Version 6.0 and later of ''[[Sirius Mods]]''.  
If you specify multiple files or groups in an <var>OPEN</var> clause, they must be separated by an AND keyword. You can also specify individual file open privileges; if not, they default to X'0221'. Multiple files or groups and explicitly specified privileges in the <var>OPEN</var> clause are supported in Version 6.0 and later of ''[[Sirius Mods]]''.  


The syntax of each file or group specification is:
The syntax of each file or group specification is:
Line 13: Line 13:
</p>
</p>


The first file or group listed in an OPEN clause is set as the default file or group context for the thread. If neither the keyword FILE nor the keyword GROUP is specified, OPEN looks first for a permanent group, then for a file, to open. It does not look for a temporary group, since one cannot yet exist at open time.  
The first file or group listed in an <var>OPEN</var> clause is set as the default file or group context for the thread. If neither the keyword FILE nor the keyword GROUP is specified, <var>OPEN</var> looks first for a permanent group, then for a file, to open. It does not look for a temporary group, since one cannot yet exist at open time.  


You can use the <var>[[CMD (JANUS DEFINE parameter)|CMD]]</var> parameter to specify a command to execute just after a file or group opens. If the <var>CMD</var> parameter specifies an INCLUDE command, the included procedure is assumed to come from the first file or group specified in the OPEN clause.  
You can use the <var>[[CMD (JANUS DEFINE parameter)|CMD]]</var> parameter to specify a command to execute just after a file or group opens. If the <var>CMD</var> parameter specifies an INCLUDE command, the included procedure is assumed to come from the first file or group specified in the <var>OPEN</var> clause.  


Examples of valid OPEN clauses follow:
Examples of valid <var>OPEN</var> clauses follow:


<p class="code"> JANUS DEFINE WEBXXX 80 WEBSERV 20 -
<p class="code"> JANUS DEFINE WEBXXX 80 WEBSERV 20 -

Revision as of 21:38, 27 February 2012

<section begin="desc" />OPEN list -- files/groups to open on connection to port.<section end="desc" />

OPEN 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 name of one or more Model 204 files or groups to be opened when a server session is initiated.

If you specify multiple files or groups in an OPEN clause, they must be separated by an AND keyword. You can also specify individual file open privileges; if not, they default to X'0221'. Multiple files or groups and explicitly specified privileges in the OPEN clause are supported in Version 6.0 and later of Sirius Mods.

The syntax of each file or group specification is:

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

The first file or group listed in an OPEN clause is set as the default file or group context for the thread. If neither the keyword FILE nor the keyword GROUP is specified, OPEN looks first for a permanent group, then for a file, to open. It does not look for a temporary group, since one cannot yet exist at open time.

You can use the CMD parameter to specify a command to execute just after a file or group opens. If the CMD parameter specifies an INCLUDE command, the included procedure is assumed to come from the first file or group specified in the OPEN clause.

Examples of valid OPEN clauses follow:

JANUS DEFINE WEBXXX 80 WEBSERV 20 - OPEN WEBPROC AND - FILE DATAPROC WITH X'0761' JANUS DEFINE OPENDOOR 1234 OPENSERV 40 - OPEN GROUP DOORPROC AND - FILE DOORDATA X'BFFF' - CMD 'I DRIVER'

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

This parameter is not valid on an FTPSERVER port definition.

References

See: List of Janus commands | List of JANUS DEFINE parameters.