SBMFNCJOB (Submit Finance Job)

SBMFNCJOB Command syntax diagram

 

Purpose

The Submit Finance Job (SBMFNCJOB) command submits a batch job so the user's finance application programs communicates with the 4701 or 4702 control unit application programs.

Use the SBMFNCJOB command only if:

• Communicating with a 4701 or 4702 control unit
• A device table and a program table have been defined using the Work with Device Table (WRKDEVTBL) and Work with Program Table (WRKPGMTBL) commands; defining a user table using the Work with User Table (WRKUSRTBL) command is optional
• The user's 4701 or 4702 control unit application program sends data (transactions) first and expects a response
• The user's 4701 or 4702 control unit application program passes data in the proper format

Restriction: This command is shipped with public *EXCLUDE authority.

 

Required Parameters

DEVTBL

Specifies the name of the device table that the finance job uses to determine which 4704 or 3624 devices it controls.

PGMTBL

Specifies the name of the program table that the finance job uses to determine, from the program ID (sent in the data stream with a finance transaction), which system user program names will process the finance transaction.

 

Optional Parameters

USRTBL

Specifies the name of the user table that the finance job uses to verify a valid finance user when a finance sign-on is received.

*NONE: No user IDs are verified.

user-table-name: Specify the name of a user table that defines user IDs for the 4700 device.

JOB

Specifies the job name that is associated with the submitted finance job. More information on this parameter is in Commonly used parameters.

QFNCJOB: The job name is submitted as QFNCJOB.

job-name: Specify the job name that is associated with the submitted finance job.

JOBD

Specifies the qualified name of the job description that is used by the finance job.

The name of the finance job can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

QFNC: The submitted finance job uses the job description QFNC.

job-description-name: Specify the name of a job description that is used by the finance job. (If no library name is given, the job description is found through the library list used by the job in which the SBMFNCJOB command is entered.)

MSGQ

Specifies the qualified name of the message queue to which messages are sent.

*WRKSTN: The finance messages are sent to the message queue of the work station from which the finance job was submitted.

*NONE: No finance messages are sent to a message queue.

The name of the message queue can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

message-queue-name: Specify the name of the message queue to which messages are sent. (If no library name is given, the library list of the job issuing the SBMFNCJOB command is used to find the queue.)

Examples for SBMFNCJOB

Example 1: Submitting a Batch Job that Communicates with Devices it Acquires

SBMFNCJOB  DEVTBL(DEVTBL1)  PGMTBL(PGMTBL1)
  USRTBL(USRTBL1)

This command submits batch job QFNCJOB. The job communicates with all devices it acquires from device table DEVTBL1, allowing users whose user IDs are found in USRTBL1 to sign on the devices. Each transaction sent by the finance devices is processed by determining, in PGMTBL1, which application program must be called, then it calls that program.

The job description used by the finance job in this example is QFNC.*LIBL. Messages sent as a result of the finance job are sent to the message queue of the work station from which the job was submitted.

Example 2: User IDs Not Verified

SBMFNCJOB  DEVTBL(DEVTBL2)  PGMTBL(PGMTBL2)
  JOB(CTFJOB)  JOBD(CTFJOBD) MSGQ(*NONE)

This command submits batch job CTFJOB. CTFJOB runs under job description CTFJOBD and does not send messages to any work station message queue while running. No verification of user IDs is performed by the finance job.

Error messages for SBMFNCJOB

*ESCAPE Messages

CPF8382

Finance job cannot be processed.