Background Processing Commands

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.

The following table shows the status codes.

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?

Below is an example:

PH-ALLOCATE
 PORT TO ALLOCATE? 100

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

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).

Below is an example:

PH-CLEAR 100

Deletes log and history records for port number 100.

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?

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.

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.

Below is an example:

PH-KILL 100

Terminates the jBASE background-processing running on port 100.

Error Messages

If you run an incorrect kill command, then you will receive any of the following error messages:

• If you do not specify a port number, you will see the following message:

  [316] WHICH LINE?

• If you specify a port number that is not currently logged on, you will see:

  PROCESS NOT LOGGED ON

• If you have no root privileges and attempt to terminate a jBASE background-processing running under a different user name, then the following error message is displayed:

  [82] YOUR SYSTEM PRIVILEGE LEVEL IS NOT SUFFICIENT FOR THIS STATEMENT.

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:

Below is an example.

PH-LINES
 LINES AVAILABLE FOR USE
 100
 103

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

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.

Below is an example.

PH-RESUME 100

Resumes the jBASE background-processing running on port 100.

Error Messages

If you run an incorrect resume command, then you will receive any of the following error messages:

• If you do not specify a port number, you will see the following message:

  [316] WHICH LINE?

• If you specify a port number that is not currently logged on, you will see the following message:

  PROCESS NOT LOGGED ON

• If you attempt to resume a jBASE background-processing running under a different user name and you do not have root privileges, then you will see the following message:

  [82] YOUR SYSTEM PRIVILEGE LEVEL IS NOT SUFFICIENT FOR THIS STATEMENT.

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:

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

Additional Notes

• If you enter a user ID or account-name other than the current user ID or account-name, then you will be prompted for the password if it exists.
• Data for any jBC program INPUT statements should be entered as separate lines for each INPUT statement, as part of the command stream.
• The OFF command is appended automatically to the command stack. If a RETURN is the only response required, then enter the left chevron character (<) in the command stream.
• It is recommended to create a JCL program that contains your list of commands and call the program from the command-stream. This will avoid you to enter a lengthy series of commands. If you use a JCL program to drive the PH-START command, then you can stack a null line in the command stream by using H<<<.
• After you enter the final command-stream command, you should see the following message:

  TASK taskid STARTED ON LINE port FOR ACCOUNT userid

  If you do not see this message, then the process was not started.

The responses to each prompt are not validated until you have completed all prompts.
• If you type an invalid response at any of the PH-START prompts, then a suitable message will be displayed. You should then repeat the entire procedure.

Error Messages

• If you specify a port number that has not been allocated, then the following message will be displayed:

  NO LINE AVAILABLE

• If you specify a port number that is not available, then the following message will be displayed:

  NO LINE AVAILABLE

• If you specify a port number to which another user is already logged on, then the following message will be displayed:

  LINE ALREADY LOGGED ON

• If you specify an invalid user ID and password or account name and password, then the following message will be displayed after you finish typing the command stream:

  INCORRECT ACCOUNT OR PASSWORD

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#

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.

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.

Below is an example.

PH-SUSPEND 10173

Resumes the jBASE background-processing running on port 10173.

Error Messages

• If you do not specify a port number, you will see the following message:

  [316] WHICH LINE?

• If you specify a port number that is not currently logged on, you will see the following message:

  PROCESS NOT LOGGED ON

• If you do not have root privileges and attempt to suspend a jBASE background processing running under a different user name, then you will see the following message:

  [82] YOUR SYSTEM PRIVILEGE LEVEL IS NOT SUFFICIENT FOR THIS STATEMENT.

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.