Submit Finance Job (SBMFNCJOB)

The Submit Finance Job (SBMFNCJOB) command submits a batch job that lets your finance application programs communicate with your 4701 or 4702 controller 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.

Parameters

Keyword	Description	Choices	Notes
DEVTBL	Device table	Name	Required, Positional 1
PGMTBL	Program table	Name	Required, Positional 2
USRTBL	User table	Name, *NONE	Optional, Positional 3
JOB	Job name	Name, QFNCJOB	Optional
JOBD	Job description	Qualified object name	Optional
	Qualifier 1: Job description	Name, QFNC
	Qualifier 2: Library	Name, LIBL, CURLIB
MSGQ	Message queue	Single values: WRKSTN, NONE Other values: Qualified object name	Optional
	Qualifier 1: Message queue	Name
	Qualifier 2: Library	Name, LIBL, CURLIB

Top

User table (USRTBL)

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

The possible values are:

*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 name (JOB)

Specifies the job name that is associated with the submitted finance job.

The possible values are:

QFNCJOB: The job name is submitted as QFNCJOB.
job-name: Specify the user-defined job name that is associated with the submitted finance job.

Job description (JOBD)

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

The possible values are:

*QFNC

The submitted finance job uses the job description QFNC.

job-description-name

Specify the name and library 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 Submit Finance Job (SBMFNCJOB) command is entered.

The possible library values are:

*LIBL: The library list is used to locate the finance job.
*CURLIB: The current library for the job is used to locate the finance job. If no library is specified as the library for the job, QGPL is used.
library-name: Specify the name of the library where the finance job is located.

Message queue (MSGQ)

Specifies the name of the message queue, to which messages can be sent while the finance job is running.

The possible values are:

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.

message-queue-name

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

The possible library values are:

*LIBL: The library list is used to find the name of the message queue.
*CURLIB: The current library for the job is used to find the name of the message queue. If no library is specified as the current library for the job, QGPL is used.
library-name: Specify the name of the library where the name of the message queue is located.

Examples

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