Submit Finance Job (SBMFNCJOB)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
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.
| Top |
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 |
Device table (DEVTBL)
Specifies the name of the device table that the finance job uses to determine which 4704 or 3624 devices it controls. This is a required parameter.
| Top |
Program table (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 user program names will process the finance transaction. This is a required parameter.
| 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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
| Top |