Background Processing in TAFC

Command	Description
LIST-JOB	Displays history and status information for each background process.
PH-ALLOCATE	Allocates port numbers for background processes.
PH-CLEAR	Clears the background task history log file.
PH-DELETE	Deallocates port numbers for background processes.
PH-KILL	Stops a background process.
PH-LINES	Displays all allocated background task port numbers.
PH-RESUME	Resumes a background process.
PH-START	Starts a background process.
PH-STATUS	Displays the background tasks history log file.
PH-SUSPEND	Suspends a background process.
Z	Starts a background process.
ZH	Starts a background process and directs output to a hold file.

LIST-JOB

The LIST-JOB command displays status and history information for each jBASE background processing.

Below is the command syntax.

LIST-JOB {(Options}

Where, options can be P, which redirects output to the Spooler.

NOTE: The information in the LIST-JOB screen is displayed in columns.

Column	Description
CMD-INPUT	The command line for the jBASE background processing provided by the Z command.
CD	The status code for the jBASE background processing.
PIB	The port number of the jBASE background process.
HF#	The spooler holds file number used by the jBASE background processing.
ACCOUNT	The user ID or account that is used by the jBASE background processing for execution.
BYLN	The port number that started the job.
BEG-DATE	The date when the jBASE background processing was started.
BEG-TIME	The time when the jBASE background processing was started.
STOP-DATE	The date when the jBASE background processing completed.
STOP-TIME	The time when the jBASE background processing completed.

NOTE: Use the PH-CLEAR command to manually clear the jBP log.

The following table shows the status codes.

Code	Description
R	Process is still active
S	Process terminated by UNIX system command
T	Process terminated normally
E	Process terminated incorrectly. Usually occurs when there are no more statements left in the command stack for the executing process.
Q	Process queued for port

PH-ALLOCATE

The jBASE PH-ALLOCATE command allocates a port number for jBASE background processes.

Below is the command syntax.

PH-ALLOCATE {port {port}} {(Options}

Where,

port – Specifies the port number to allocate
port{port} – Specifies that all port with the range to be allocated.
Options – This can be F, which allocate port numbers for foreground processes and B, which allocate port numbers for background processes (default).

After you run the command, you will get the following prompt:

PORT TO ALLOCATE?

NOTE: Enter the port number to allocate to the available list of jBASE background ports. The port number remains allocated unless you de-allocate it with the PH-DELETE command. You can use the allocated port numbers for normal foreground processes when not being used for jBASE background processes. Also, ensure you have root privileges for this command.

Below is an example:

PH-ALLOCATE
 PORT TO ALLOCATE? 100

The port number 100 is allocated to the jBASE background process.

PH-CLEAR

The jBASE PH-CLEAR command clears the jBP log and history file.

Below is the command syntax.

PH-CLEAR {taskid | port} {(Options}

Where,

taskid – Specifies the entries for the task ID be to be cleared.
port – Specifies the entries for the port number be to be cleared.
Options – This can be I, which clears entries interactively (prompt before deleting).

NOTE: The super user or administrators can execute this command. If a task ID, port number or interactive option is not specified, then all entries in the log file will be deleted.

Below is an example:

PH-CLEAR 100

Deletes log and history records for port number 100.

PH-DELETE

The jBASE PH-DELETE command deletes a port number allocated for the jBASE background processing.

Below is the command syntax.

PH-DELETE {port {port}} {(Options}

Where,

port – Specifies the port to be deleted.
port {port} – Specifies the range of port to be deleted.
Options – This can be F, which deletes port numbers for foreground processes and B, which deletes port numbers for background processes (default).

After running the command, the following prompt appears:

PORT TO DELETE?

NOTE: Enter the port number to delete from the available list of jBASE background ports. The port number remains unavailable for jBASE background processes until allocated by the PH-ALLOCATE command. Also, ensure you have the root privileges for this command.

Below is an example:

PH-DELETE 
PORT TO DELETE? 100
 100 DELETED FROM SERVICE

Port number 100 is now no longer available for jBASE background processing.

PH-KILL

The jBASE PH-KILL command stops the specified jBASE background processing.

Below is the command syntax.

PH-KILL n

Where,

n – Specifies the port number to be terminated.

NOTE: You should have root privileges to terminate the port number if the jBASE background processing is running under a different user name.

Below is an example:

PH-KILL 100

Terminates the jBASE background-processing running on port 100.

PH-LINES

The jBASE PH-LINES command displays all allocated jBASE background task port numbers.

Below is the command syntax.

PH-LINES port {Options}

Where, port specifies a port number to be displayed and options can be any of the following:

Option	Description
C	Compress display to only active ports
V	Verbose display
P	Direct output to spooler
N	No pagination
F	Delete port numbers for foreground processes
B	Delete port numbers for background processes (default)

Below is an example.

PH-LINES
 LINES AVAILABLE FOR USE
 100
 103

The ports 100 and 103 is available for jBASE background processing.

PH-RESUME

The jBASE PH-RESUME command resumes a suspended jBASE background processing.

Below is the command syntax.

PH-RESUME n

Where, n is the port number associated with the jBASE background processing to be resumed.

NOTE: You should have root privileges if the jBASE background processing is running under a different user name.

Below is an example.

PH-RESUME 100

Resumes the jBASE background-processing running on port 100.

PH-START

The jBASE PH-START command starts a jBASE background processing.

Below is the command syntax.

PH-START

On running the command, you get the following prompts:

ENTER TASKID FOR PH TASK? {task-id}
ENTER LINE# FOR PH TASK? {port-number}
ENTER OPTIONS? {options}
ENTER ACCOUNT FOR PH JOB ? {user-id/account-name}
ENTER COMMAND STREAM <CR TO END>
USE “<” FOR A NULL LINE
command-stream

Where,

task-id is the name to identify the jBASE background processing. The default name is None. This name is recorded in the jBP log file and displayed by PH-STATUS.
port-number is the number of the port on which the jBASE background processing should run. If you do not specify a port number, then the next available port number (starting with the highest number in use) will be chosen.
options allow you to queue another job for the jBASE background task port, redirect stderr to stdout, or redirect the output from the port to a terminal or a spooler hold file. If you use an option, then the spooler hold file will hold the output. If no options are specified, then a spooler hold file is created and output is suppressed. Options can be one or more of the following:

Option	Description
H	Hushes the PH-START message
P	Prints the hold file on the printer assigned to your process after the jBASE background processing is finished. The hold file is not deleted.
N	No logging. A hold file is not created and all terminal output is lost.
T	Use terminal output. Assumes that a terminal device is associated with the jBASE background processing. No hold file is created.
Q	Queue this task to a currently active jBASE background process.
E	Redirect stderr to stdout. This ensures no loss of output to the hold file.
userid/account-name	Specifies the name under which the jBASE background processing command stream is to be executed.
command-stream	Specifies a list of commands and application inputs to be executed. It can be any valid command except LOGTO. Terminate the command stream by pressing <Enter> on a blank line.

Below is an example.

This example starts the jBASE background processing named SALESREP.

PH-START
 ENTER TASKID FOR PH TASK? SALESREP
 ENTER PORT NUMBER FOR TIPH TASK? 23
 ENTER OPTIONS? HT
 ENTER ACCOUNT FOR PH JOB? SALES
 ENTER COMMAND STREAM <CR TO END>
 USE “<” FOR A NULL LINE 
 >SP-ASSIGN HS
 >SORT SALES95 (P)
 ><RETURN>
 TASK SALESREP STARTED ON LINE 23 FOR ACCOUNT SALES

PH-STATUS

The jBASE PH-STATUS command displays status and history information for each jBASE background process.

Below is the command syntax.

PH-STATUS {task-id n} {(Options}

Where,

task-id is the name of the jBASE background task process specified in the PH-START procedure. Use an asterisk (*) to indicate that you want all tasks for port number n.
n is the port number of the background process indicating the limit of display.
Options can be P, which means redirect output to the spooler.

The information in the PH-STATUS screen is shown in columns:

TASK-ID..LINE ACCOUNT. STARTER-ACC DATE....... TIME.. STATUS OP OUTFL#

Column	Description
TASK-ID	The name identifier given to the jBASE background process by PH-START.
LINE	The port number running the jBASE background process.
ACCOUNT	The user ID or account-name that the background process is using for execution.
STARTER-ACC	The name of the user ID or account from which the background process was started.
DATE	The date the jBASE background process was started.
TIME	The time the jBASE background process was started.
STATUS	The current status of the background process (see Status Codes below).
OP	The options that were assigned to the jBASE background process.
OUTFL#	The spooler job number where output has been redirected.

Below is an example.

> PH-STATUS
TASK-ID..LINE ACCOUNT. STARTER-ACC DATE....... TIME.. STATUS OP OUTFL#
     SALESREP 101  SALES    SALES       06 JAN 1995 09:15  A       12
     INVUP    103  INV      ACCOUNTS    06 JAN 1995 10:30  T        T
     ACC3     130  ACCOUNTS ACCOUNTS    06 JAN 1995 13:00  K       42
     TEL.LIST 999  ADMIN    ADMIN       06 JAN 1995 15:04  A        6

Status Codes

Status	Description
A	Process is still active.
S	Process terminated by UNIX system command.
T	Process terminated normally.
X	Process terminated incorrectly. Usually occurs when the executing process requires input but there are no more statements left in the command stack.
K	Process terminated by the PH-KILL command.
Q	Process queued for port.

PH-SUSPEND

The jBASE PH-SUSPEND command suspends jBASE background processing.

Below is the command syntax.

PH-SUSPEND n

Where, n is the port number associated with the jBASE background processing to be suspended.

NOTE: You should have root privileges to suspend a jBASE background processing, if it is running under a different user name.

Below is an example.

PH-SUSPEND 10173

Resumes the jBASE background-processing running on port 10173.

ZH

The jBASE ZH command starts jBASE background processing and directs output to a hold file.

Below is the command syntax.

ZH {port} {command}

On running the command, the following prompt appears:

ENTER ACCOUNT FOR PH TASK? {userid/account-name}
ENTER COMMAND TO EXECUTE ?{command}
ENTER DATA ASSOCIATED WITH COMMAND
USE “<” FOR A NULL LINE
>{input}

Where,

port is the port number on which to run the jBASE background processing.
command is the command to execute the jBASE background processing.
userid/account-name is the name to use when executing the jBASE background processing.
input is the data to supply to jBC program INPUT statements. You should place each input on a separate line.

Background Processing Commands

Syntax and Examples