START command: Starting an application subsystem: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (Automatically generated page update)
 
m (→‎Usage notes: add link)
Line 26: Line 26:
The user class determines whether this command can be issued.
The user class determines whether this command can be issued.
==Usage notes==
==Usage notes==
<p>If the application subsystem is inactive when the START command is issued, the Subsystem Management facility opens all the application subsystem files, builds core-resident control blocks, and includes the application subsystem initialization procedure. </p>
<p>
<p>If the application subsystem is draining when the command is issued, the Subsystem Management facility makes the subsystem available for use.</p>
If the application subsystem is inactive when the <var>START</var> command is issued, the Subsystem Management facility opens all the application subsystem files, builds core-resident control blocks, and includes the application subsystem initialization procedure. </p>
<p>If the subsystem is not autostart, then information passed via this parameter can be used only by the subsystem utilization procedure. Otherwise, the subsystem LOGIN procedure can make use of the information passed.  </p>
<p>
<p>For more information about START SUBSYSTEM when it specifies a subsystem that uses remote files, see the <var>Parallel Query Option/204 User's Guide.</var> </p>
If the application subsystem is draining when the command is issued, the Subsystem Management facility makes the subsystem available for use.</p>
<p>
If the subsystem is not autostart, then information passed via this parameter can be used only by the subsystem utilization procedure. Otherwise, the subsystem <var>LOGIN</var> procedure can make use of the information passed.  </p>
<p>
For more information about <var>START SUBSYSTEM</var> when it specifies a subsystem that uses remote files, see [[PQO: Scattered APSY subsystems#Subsystem command processing|PQO subsystem command processing]]. </p>
 
[[Category:Commands]]
[[Category:Commands]]

Revision as of 22:08, 28 January 2016

Summary

Privileges
Defined in the subsystem definition
Function
Activates an application subsystem

Syntax

START SUBSYSTEM subsysname [parameters]

Where:

subsysname is the name of the application subsystem, comprised of a maximum of 10 characters.
parameters specify subsystem-specific parameters. As many as 255 characters of information can be entered.

Syntax notes

The user class determines whether this command can be issued.

Usage notes

If the application subsystem is inactive when the START command is issued, the Subsystem Management facility opens all the application subsystem files, builds core-resident control blocks, and includes the application subsystem initialization procedure.

If the application subsystem is draining when the command is issued, the Subsystem Management facility makes the subsystem available for use.

If the subsystem is not autostart, then information passed via this parameter can be used only by the subsystem utilization procedure. Otherwise, the subsystem LOGIN procedure can make use of the information passed.

For more information about START SUBSYSTEM when it specifies a subsystem that uses remote files, see PQO subsystem command processing.