NetBatch:NBEXEC/Starting NBexec - Revision history

Majestix: Majestix moved page Manuals:NetBatch:NBEXEC/Starting NBexec to NetBatch:NBEXEC/Starting NBexec without leaving a redirect

2026-04-24T05:10:26Z

Majestix moved page Manuals:NetBatch:NBEXEC/Starting NBexec to NetBatch:NBEXEC/Starting NBexec without leaving a redirect

← Older revision		Revision as of 07:10, 24 April 2026
(No difference)

Majestix at 17:54, 23 April 2026

2026-04-23T17:54:11Z

← Older revision		Revision as of 19:54, 23 April 2026
Line 122:		Line 122:
	{{terminal\|title=TACL\|style=width: 80ch;margin-left: 4em;\|text=3> NBEXEC/IN CTRL/SY}}		{{terminal\|title=TACL\|style=width: 80ch;margin-left: 4em;\|text=3> NBEXEC/IN CTRL/SY}}

⚫	[[Category:NBEXEC]]
	[[Category:Manuals]]		[[Category:Manuals]]
		⚫	[[Category:NBEXEC]]

Majestix: added Category:Manuals using HotCat

2026-04-23T17:53:41Z

added Category:Manuals using HotCat

← Older revision		Revision as of 19:53, 23 April 2026
Line 123:		Line 123:

	[[Category:NBEXEC]]		[[Category:NBEXEC]]
			[[Category:Manuals]]

Majestix: added Category:NBEXEC using HotCat

2026-04-23T17:29:38Z

added Category:NBEXEC using HotCat

← Older revision		Revision as of 19:29, 23 April 2026
Line 121:		Line 121:
	The following example shows how to make NBEXEC perform a syntax check on a single control file:		The following example shows how to make NBEXEC perform a syntax check on a single control file:
	{{terminal\|title=TACL\|style=width: 80ch;margin-left: 4em;\|text=3> NBEXEC/IN CTRL/SY}}		{{terminal\|title=TACL\|style=width: 80ch;margin-left: 4em;\|text=3> NBEXEC/IN CTRL/SY}}

			[[Category:NBEXEC]]

Majestix at 17:27, 23 April 2026

2026-04-23T17:27:13Z

← Older revision		Revision as of 19:27, 23 April 2026
Line 42:		Line 42:
	! Description		! Description
	\|-		\|-
	\| '''A'''{{small\|PPEND}} \|\| {{~~Cross~~}} \|\| {{nowrap\|{{~~kbd~~\|A}}}} ~~\|\| Specifies that output is to be appended to the current list file if it exists. NBEXEC defaults to overwrite the <list file> if one exists.~~		\| '''A'''{{small\|PPEND}} \|\| {{notAvail}} \|\| {{nowrap\|{{key press\|A}}}}
			\| Specifies that output is to be appended to the current list file if it exists. NBEXEC defaults to overwrite the <list file> if one exists.
	\|-		\|-
			\| '''B'''{{small\|ACKUPCPU}} \|\| <cpu> \|\| {{nowrap\|{{key press\|B 15}}}}
	~~\| '''B'''ACKUPCPU \|\| <cpu> \|\| {{nowrap\|{{kbd\|B 15}}}} \|~~\| NBEXEC is able to function as a NonStop process. If the primary CPU running NBEXEC fails, a backup copy can takeover, determine what recovery the job may require, and resume execution from the appropriate place in the input control file. The number <cpu> must be the number of an available CPU, and must not be the CPU allocated to the EXECUTOR under which NBEXEC is started. Use -1 to indicate that NBEXEC should start its backup process in the highest available CPU.		\| NBEXEC is able to function as a NonStop process. If the primary CPU running NBEXEC fails, a backup copy can takeover, determine what recovery the job may require, and resume execution from the appropriate place in the input control file. The number <cpu> must be the number of an available CPU, and must not be the CPU allocated to the EXECUTOR under which NBEXEC is started. Use -1 to indicate that NBEXEC should start its backup process in the highest available CPU.
	\|-		\|-
	\| '''C'''{{small\|LASS}} \|\| <cname> \|\| {{nowrap\|{{~~kbd~~\|C payroll}}}} ~~\|\| Specifies <cname> of up to eight alphanumeric characters to appear on the <list file> header page and possibly the spooler REPORTNAME. See the SPOOLREP attribute for details.~~		\| '''C'''{{small\|LASS}} \|\| <cname> \|\| {{nowrap\|{{key press\|C payroll}}}}
			\| Specifies <cname> of up to eight alphanumeric characters to appear on the <list file> header page and possibly the spooler REPORTNAME. See the SPOOLREP attribute for details.
	\|-		\|-
			\| '''D{{small\|PBUG}} \|\| {{notAvail}} \|\| {{key press\|D}}
	~~\| '''D{{small\|PBUG}} \|\| {{Na}} \|\| D \|~~\| Is used to force NBEXEC to call DEBUG. This is only useful for debugging purposes when NBEXEC is run at a terminal rather than as a NetBatch job.		\| Is used to force NBEXEC to call DEBUG. This is only useful for debugging purposes when NBEXEC is run at a terminal rather than as a NetBatch job.
	\|-		\|-
	\| '''ID''' \|\| <id> \|\| {{nowrap\|{{~~kbd~~\|ID A2345678}}}} \|\| Assigns a name of one alphabetic plus up to seven alpha numeric characters to a job to distinguish it among other jobs on the same <class>. Lower case characters are upshifted. This name appears on the job list file.		\| '''ID''' \|\| <id> \|\| {{nowrap\|{{key press\|ID A2345678}}}}
			\| Assigns a name of one alphabetic plus up to seven alpha numeric characters to a job to distinguish it among other jobs on the same <class>. Lower case characters are upshifted. This name appears on the job list file.
	\|-		\|-
			\| '''ID''' \|\| T{{small\|ERM}}\|\| {{nowrap\|{{key press\|ID T}}}}
	~~\| '''ID''' \|\| T{{small\|ERM}} \|\| {{nowrap\|{{kbd\|ID T}}}} \|~~\| An <id> of "TERM" or "T" will cause NBEXEC to emulate a physical terminal, rather than a process. Processes compiled using COBOL74 ACCEPT/DISPLAY verbs will run under control of NBEXEC if ID TERM is specified. Before using ID TERM, users should be aware that many programs behave differently when they read commands from a terminal. For example, it is common for a program to request a continuation response when a full screen of output has been displayed.		\| An <id> of "TERM" or "T" will cause NBEXEC to emulate a physical terminal, rather than a process. Processes compiled using COBOL74 ACCEPT/DISPLAY verbs will run under control of NBEXEC if ID TERM is specified. Before using ID TERM, users should be aware that many programs behave differently when they read commands from a terminal. For example, it is common for a program to request a continuation response when a full screen of output has been displayed.
	\|-		\|-
	\| '''L'''{{small\|ABEL}} \|\| <label> \|\| {{nowrap\|{{~~kbd~~\|L WORK010}}}} ~~\|\| Causes NBEXEC processing to begin at the specified label in the control file.~~		\| '''L'''{{small\|ABEL}} \|\| <label> \|\| {{nowrap\|{{key press\|L WORK010}}}}
			\| Causes NBEXEC processing to begin at the specified label in the control file.
	\|-		\|-
	\| '''L'''{{small\|IMIT}} \|\| <hh:mm> \|\| {{nowrap\|{{~~kbd~~\|L 02:00}}}} ~~\|\| Specifies a maximum time limit for the NBEXEC job. Must be between 00:00 and 99:59, with the default being 01:00 (one hour).~~		\| '''L'''{{small\|IMIT}} \|\| <hh:mm> \|\| {{nowrap\|{{key press\|L 02:00}}}}
			\| Specifies a maximum time limit for the NBEXEC job. Must be between 00:00 and 99:59, with the default being 01:00 (one hour).
	<br>		<br>
	NBEXEC will abort the job once this limit is exceeded logging the fact to <list file>. Jobs will issue a warning message to both the job list file and the supervisor log 15 minutes before timing out.		NBEXEC will abort the job once this limit is exceeded logging the fact to <list file>. Jobs will issue a warning message to both the job list file and the supervisor log 15 minutes before timing out.
	\|-		\|-
			\| '''N'''{{small\|AME}} \|\| <mname> \|\| {{nowrap\|{{key press\|N JOB45679}}}}
	~~\| '''N'''{{small\|AME}} \|\| <mname> \|\| {{nowrap\|{{kbd\|N JOB45679}}}} \|~~\| Specifies a name of up to eight alphanumeric characters to appear on the <list file> header page. It will be used by NBEXEC when identifying itself in $MESSAGE commands (rather than the control file name) and it can be used when building a spooler REPORTNAME attribute for the <list file>. See the SPOOLREP attribute for details.		\| Specifies a name of up to eight alphanumeric characters to appear on the <list file> header page. It will be used by NBEXEC when identifying itself in $MESSAGE commands (rather than the control file name) and it can be used when building a spooler REPORTNAME attribute for the <list file>. See the SPOOLREP attribute for details.
	\|-		\|-
	\| '''P'''{{small\|~~RGE~~}} \|\| {{na}} \|\| {{nowrap\|{{~~kbd~~\|P}}}} ~~\|\| Specifies that the list file will be purged if the job terminates successfully. Therefore, if~~		\| '''P'''{{small\|URGE}} \|\| {{notAvail}} \|\| {{nowrap\|{{key press\|P}}}}
			\| Specifies that the list file will be purged if the job terminates successfully. Therefore, if
	<br>		<br>
	::$IF #ERROR returned TRUE,		::$IF #ERROR returned TRUE,
Line 70:		Line 80:
	the list file would be created. If the list file is the spooler and the job terminates successfully, the spooler entry is not deleted.		the list file would be created. If the list file is the spooler and the job terminates successfully, the spooler entry is not deleted.
	\|-		\|-
	\| '''S'''{{small\|POOLREP}} \|\| <c> \|\| {{nowrap\|{{~~kbd~~\|S U}}}} ~~\|\| Controls the format of the REPORTNAME spooler attribute when <list file> is a spooler collector.~~		\| '''S'''{{small\|POOLREP}} \|\| <c> \|\| {{nowrap\|{{key press\|S U}}}}
			\| Controls the format of the REPORTNAME spooler attribute when <list file> is a spooler collector.

	::{\| class="wikitable"		::{\| class="wikitable"
	! <c> !! REPORTNAME		! <c> !! REPORTNAME
	\|-		\|-
	\| '''C'''{{small\|LASS<}} \|\| <cname> grp usr		\| '''C'''{{small\|LASS<}} \|\| <cname> grp usr
	\|-		\|-
	\| '''U'''{{small\|SER}} \|\| GROUP USER		\| '''U'''{{small\|SER}} \|\| GROUP USER
Line 85:		Line 96:
	and USER, usr correspond to the Guardian90 UserID name and number of the NBEXEC process owner.		and USER, usr correspond to the Guardian90 UserID name and number of the NBEXEC process owner.
	\|-		\|-
	\| '''SY'''{{small\|NTAX}} \|\| {{na}} \|\| {{nowrap\|{{~~kbd~~\|SY}}}} ~~\|\| Is specified to perform syntax validation of control cfile only.~~		\| '''SY'''{{small\|NTAX}} \|\| {{notAvail}} \|\| {{nowrap\|{{key press\|SY}}}}
			\| Is specified to perform syntax validation of control cfile only.

	When NBEXEC begins processing a control file, it first scans the file to locate labels, and validate		When NBEXEC begins processing a control file, it first scans the file to locate labels, and validate
	that there are no obvious syntax errors. If errorsare detected, the job will terminate immediately.		that there are no obvious syntax errors. If errorsare detected, the job will terminate immediately.
	If SYNTAX was specified, the job always terminates after the syntax check. SYNTAX would normally beused immediately after altering a control file to verify that no mistakes were made.		If SYNTAX was specified, the job always terminates after the syntax check. SYNTAX would normally beused immediately after altering a control file to verify that no mistakes were made.
	\|-		\|-
	\| '''X'''{{small\|PRI}} \|\| <xpri> \|\| {{nowrap\|{{~~kbd~~\|X #}}}} \|\|		\| '''X'''{{small\|PRI}} \|\| <xpri> \|\| {{nowrap\|{{key press\|X #}}}} \|\|
	\|-
	\| Example \|\| Example \|\| Example \|\| Example
	\|}		\|}

Line 100:		Line 109:
	The following example shows how to prevent NBEXEC from running more than two hours:		The following example shows how to prevent NBEXEC from running more than two hours:
	{{terminal\|title=TACL\|style=width: 80ch;margin-left: 4em;\|text=1> NBEXEC/NAME, IN X, OUT $S/L2:0}}		{{terminal\|title=TACL\|style=width: 80ch;margin-left: 4em;\|text=1> NBEXEC/NAME, IN X, OUT $S/L2:0}}

	or via $ZBAT, the default NetBatch scheduler:		or via $ZBAT, the default NetBatch scheduler:
	{{terminal\|title=TACL\|style=width: 80ch;margin-left: 4em;\|text=1> BATCHCOM; SUBMIT REPORT,IN REPORT,OUT $S, STARTUP "L E-O-M,L2:0"}}		{{terminal\|title=TACL\|style=width: 80ch;margin-left: 4em;\|text=1> BATCHCOM; SUBMIT REPORT,IN REPORT,OUT $S, STARTUP "L E-O-M,L2:0"}}

	{{~~kbd~~\|L}} is an abbreviation of the command "LIMIT". "LIMIT" is the command used to specify a time limit for a job, while "2:0" is the value accompanying "LIMIT".		{{key press\|L}} is an abbreviation of the command "LIMIT". "LIMIT" is the command used to specify a time limit for a job, while "2:0" is the value accompanying "LIMIT".
	{{~~kbd~~\|L}} is also a valid abbreviation of the command "LABEL".		{{key press\|L}} is also a valid abbreviation of the command "LABEL".

	The following example shows how to make NBEXEC emulate a physical terminal for use by the processes created during the job:		The following example shows how to make NBEXEC emulate a physical terminal for use by the processes created during the job:

	{{terminal\|title=TACL\|style=width: 80ch;margin-left: 4em;\|text=2> NBEXEC/IN COMP/ID T}}		{{terminal\|title=TACL\|style=width: 80ch;margin-left: 4em;\|text=2> NBEXEC/IN COMP/ID T}}

Majestix at 12:27, 23 April 2026

2026-04-23T12:27:16Z

← Older revision		Revision as of 14:27, 23 April 2026
Line 2:		Line 2:

	NBEXEC is invoked by TACL, or specified as a NetBatch EXECUTOR-PROGRAM as follows:		NBEXEC is invoked by TACL, or specified as a NetBatch EXECUTOR-PROGRAM as follows:
	~~<div~~ style="width: 80ch">		{{terminal\|title=TACL\|style=width: 80ch;margin-left: 4em;\|text=
	{{terminal\|title=TACL\|text=
	>RUN NBEXEC/NAME [<pname>], IN <control file> &		>RUN NBEXEC/NAME [<pname>], IN <control file> &
	[,OUT <list file>]/[<command>,...]		[,OUT <list file>]/[<command>,...]
	}}		}}
	</div>

	:or		:or

	~~<div~~ style="width: 80ch; ~~.tpl-terminal {~~margin-left: ~~5em~~;~~}">~~		{{terminal\|title=TACL\|style=width: 80ch;margin-left: 4em;\|text=
	{{terminal\|title=TACL\|text=
	>BATCHCOM;SUBMIT <job-name>, IN <control file> [,OUT <list file>] &		>BATCHCOM;SUBMIT <job-name>, IN <control file> [,OUT <list file>] &
	, EXECUTOR-PROGRAM NBEXEC &		, EXECUTOR-PROGRAM NBEXEC &
	[, STARTUP "<command>,..." ]		[, STARTUP "<command>,..." ]
	}}		}}

	</div>
	:where:		:where:

Line 102:		Line 99:

	The following example shows how to prevent NBEXEC from running more than two hours:		The following example shows how to prevent NBEXEC from running more than two hours:
	~~<div~~ style="width: 80ch;margin-left: 4em;">		{{terminal\|title=TACL\|style=width: 80ch;margin-left: 4em;\|text=1> NBEXEC/NAME, IN X, OUT $S/L2:0}}
	{{terminal\|title=TACL\|text=1> NBEXEC/NAME, IN X, OUT $S/L2:0}}
	</div>
	or via $ZBAT, the default NetBatch scheduler:		or via $ZBAT, the default NetBatch scheduler:
		⚫	{{terminal\|title=TACL\|style=width: 80ch;margin-left: 4em;\|text=1> BATCHCOM; SUBMIT REPORT,IN REPORT,OUT $S, STARTUP "L E-O-M,L2:0"}}

	<div style="width: 80ch;margin-left: 4em;">
⚫	{{terminal\|title=TACL\|text=1> BATCHCOM; SUBMIT REPORT,IN REPORT,OUT $S, STARTUP "L E-O-M,L2:0"}}
	</div>

	{{kbd\|L}} is an abbreviation of the command "LIMIT". "LIMIT" is the command used to specify a time limit for a job, while "2:0" is the value accompanying "LIMIT".		{{kbd\|L}} is an abbreviation of the command "LIMIT". "LIMIT" is the command used to specify a time limit for a job, while "2:0" is the value accompanying "LIMIT".
Line 116:		Line 108:
	The following example shows how to make NBEXEC emulate a physical terminal for use by the processes created during the job:		The following example shows how to make NBEXEC emulate a physical terminal for use by the processes created during the job:

	<!--<div style="width: 80ch;margin-left: 4em;">-->
	{{terminal\|title=TACL\|style=width: 80ch;margin-left: 4em;\|text=2> NBEXEC/IN COMP/ID T}}		{{terminal\|title=TACL\|style=width: 80ch;margin-left: 4em;\|text=2> NBEXEC/IN COMP/ID T}}

	<!--</div>-->
	The following example shows how to make NBEXEC perform a syntax check on a single control file:		The following example shows how to make NBEXEC perform a syntax check on a single control file:
	~~<div~~ style="width: 80ch;margin-left: 4em;">		{{terminal\|title=TACL\|style=width: 80ch;margin-left: 4em;\|text=3> NBEXEC/IN CTRL/SY}}
	{{terminal\|title=TACL\|text=3> NBEXEC/IN CTRL/SY}}
	</div>

Majestix at 11:54, 23 April 2026

2026-04-23T11:54:23Z

← Older revision		Revision as of 13:54, 23 April 2026
Line 116:		Line 116:
	The following example shows how to make NBEXEC emulate a physical terminal for use by the processes created during the job:		The following example shows how to make NBEXEC emulate a physical terminal for use by the processes created during the job:

	<div style="width: 80ch;margin-left: 4em;">		<!--<div style="width: 80ch;margin-left: 4em;">-->
	{{terminal\|title=TACL\|text=2> NBEXEC/IN COMP/ID T}}		{{terminal\|title=TACL\|style=width: 80ch;margin-left: 4em;\|text=2> NBEXEC/IN COMP/ID T}}
	</div>		<!--</div>-->
	The following example shows how to make NBEXEC perform a syntax check on a single control file:		The following example shows how to make NBEXEC perform a syntax check on a single control file:
	<div style="width: 80ch;margin-left: 4em;">		<div style="width: 80ch;margin-left: 4em;">

Majestix at 11:08, 23 April 2026

2026-04-23T11:08:56Z

← Older revision		Revision as of 13:08, 23 April 2026
Line 11:		Line 11:
	:or		:or

	<div style="width: 80ch">		<div style="width: 80ch; .tpl-terminal {margin-left: 5em;}">
	{{terminal\|title=TACL\|text=		{{terminal\|title=TACL\|text=
	>BATCHCOM;SUBMIT <job-name>, IN <control file> [,OUT <list file>] &		>BATCHCOM;SUBMIT <job-name>, IN <control file> [,OUT <list file>] &
Line 102:		Line 102:

	The following example shows how to prevent NBEXEC from running more than two hours:		The following example shows how to prevent NBEXEC from running more than two hours:
	<div style="width: 80ch">		<div style="width: 80ch;margin-left: 4em;">
	{{terminal\|title=TACL\|text=1> NBEXEC/NAME, IN X, OUT $S/L2:0}}		{{terminal\|title=TACL\|text=1> NBEXEC/NAME, IN X, OUT $S/L2:0}}
	</div>		</div>
	or via $ZBAT, the default NetBatch scheduler:		or via $ZBAT, the default NetBatch scheduler:

	<div style="width: 80ch">		<div style="width: 80ch;margin-left: 4em;">
	{{terminal\|title=TACL\|text=1> BATCHCOM; SUBMIT REPORT,IN REPORT,OUT $S, STARTUP "L E-O-M,L2:0"}}		{{terminal\|title=TACL\|text=1> BATCHCOM; SUBMIT REPORT,IN REPORT,OUT $S, STARTUP "L E-O-M,L2:0"}}
	</div>		</div>
Line 116:		Line 116:
	The following example shows how to make NBEXEC emulate a physical terminal for use by the processes created during the job:		The following example shows how to make NBEXEC emulate a physical terminal for use by the processes created during the job:

	<div style="width: 80ch">		<div style="width: 80ch;margin-left: 4em;">
	{{terminal\|title=TACL\|text=2> NBEXEC/IN COMP/ID T}}		{{terminal\|title=TACL\|text=2> NBEXEC/IN COMP/ID T}}
	</div>		</div>
	The following example shows how to make NBEXEC perform a syntax check on a single control file:		The following example shows how to make NBEXEC perform a syntax check on a single control file:
	<div style="width: 80ch">		<div style="width: 80ch;margin-left: 4em;">
	{{terminal\|title=TACL\|text=3> NBEXEC/IN CTRL/SY}}		{{terminal\|title=TACL\|text=3> NBEXEC/IN CTRL/SY}}
	</div>		</div>

Majestix at 10:27, 23 April 2026

2026-04-23T10:27:18Z

Show changes

Majestix at 05:25, 23 April 2026

2026-04-23T05:25:10Z

Show changes