NEWSESOPEN (JANUS DEFINE parameter): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
(Automatically generated page update)
 
(24 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:NEWSESOPEN}}
<span class="pageSubtitle">NEWSESOPEN list &mdash; open files/groups before NEWSESCMD execution</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]].
<var>NEWSESOPEN</var> is a parameter on <var>[[JANUS DEFINE]]</var>, 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 <code>AND</code> keyword. You can specify individual file open privileges, or allow them to default to X'0221'.  
This parameter specifies the names of one or more <var class="product">Model 204</var> files or groups to be opened before any <var>[[NEWSESCMD (JANUS DEFINE parameter)|NEWSESCMD]]</var> 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
The syntax of each file or group specification is


<p class="code"> [FILE | GROUP] name [ [WITH] privs]
<p class="syntax"><span class="squareb">[</span><span class="literal">FILE</span> <span class="squareb">|</span> <span class="literal">GROUP</span><span class="squareb">]</span> <span class="term">name</span> <span class="squareb">[ [</span><span class="literal">WITH</span><span class="squareb">]</span> <span class="term">privs</span><span class="squareb">]</span>
</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 <var>NEWSESOPEN</var> 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.  
The first file or group listed in an <var>[[OPEN (JANUS DEFINE parameter)|OPEN]]</var> clause is set as the default file or group context for the thread during <var>NEWSESCMD</var> command processing.  


Additional NEWSESOPEN processing notes:
Additional <var>NEWSESOPEN</var> 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>If the <var>NEWSESCMD</var> parameter specifies an INCLUDE command, the included procedure is assumed to come from the first file or group specified in the <var>NEWSESOPEN</var> 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><var>NEWSESOPEN</var> lets you have data files automatically opened for <var>NEWSESCMD</var> processing, which can be especially useful if the <var>NEWSESCMD</var> 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 <var>NEWSESCMD</var> processing, whether or not they were opened as a result of a <var>NEWSESOPEN</var> 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 <var>NEWSESCMD</var> clause in a port definition, the files and groups specified by the <var>NEWSESOPEN</var> clause are not opened. Thus, the <var>NEWSESOPEN</var> parameter is essentially useless except in conjunction with the <var>NEWSESCMD</var> parameter.
</ul>
</ul>


Examples of some valid NEWSESOPEN clauses:
Examples of some valid <var>NEWSESOPEN</var> clauses:
<p class="code"> JANUS DEFINE WEBXXX 80 WEBSERV 20 -
<p class="code">JANUS DEFINE WEBXXX 80 WEBSERV 20                 -
NEWSESOPEN CERTPROC AND -
NEWSESOPEN CERTPROC AND FILE CERTDATA WITH X'BFFF' -
FILE CERTDATA WITH X'BFFF' -
NEWSESCMD WEBLOGIN
NEWSESCMD WEBLOGIN
   
   
JANUS DEFINE TELNETSRV 23 SRVSOCK 10 -
JANUS DEFINE TELNETSRV 23 SRVSOCK 10 -
NEWSESOPEN TELNETP -
NEWSESOPEN TELNETP                   -
NEWSESCMD 'INCLUDE TELNETLOGIN'
NEWSESCMD 'INCLUDE TELNETLOGIN'
</p>
</p>




NEWSESOPEN is supported in Version 6.0 and later of ''[[Sirius Mods]]''.  
This parameter is valid for <var>[[JANUS DEFINE#type|SRVSOCK]]</var>, <var>[[JANUS DEFINE#type|WEBSERV]]</var>, and <var>[[JANUS DEFINE#type|TNSERV]]</var> port types.  


This parameter is valid for SRVSOCK, WEBSERV, and TNSERV port types.  
This parameter is '''not''' valid on an <var>[[JANUS DEFINE#type|FTPSERVER]]</var> port definition.


This parameter is '''not''' valid on an FTPSERVER port definition.
==See also==
 
<ul>
==References==
<li>[[List of Janus commands]]
 
<li>[[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]]
See: [[List of Janus commands]] | [[JANUS DEFINE#parmlist|List of JANUS DEFINE parameters]].
</ul>


[[Category:JANUS DEFINE parameters|NEWSESOPEN]]
[[Category:JANUS DEFINE parameters|NEWSESOPEN]]

Latest revision as of 22:21, 16 April 2013

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

Retrieved from "https://m204wiki.rocketsoftware.com/index.php?title=NEWSESOPEN_(JANUS_DEFINE_parameter)&oldid=56207"