NetBatch Management Programming Manual

Communicating With the NetBatch Subsystem
NetBatch Management Programming Manual—522462-003
2-5
Closing a Scheduler
When your application opens the scheduler, it must check for file-system errors in
addition to the errors listed in Table 2-1. For information on file-system errors, see the
Guardian Procedure Calls Reference Manual.
Closing a Scheduler
When your application has finished communicating with the scheduler, it must close
the scheduler using the mechanism appropriate to your programming language (for
example, Guardian procedure FILE_CLOSE_ for C and TAL, the CLOSE verb for
COBOL, or the #REQUESTER built-in function for the TACL program). For examples
showing programmatic scheduler closure, see Appendix C, Sample Programs.
Table 2-1. Open Errors for the Scheduler
Error Cause, Effect, and Recovery
11 File or device
does not exist
Cause. The scheduler did not recognize the process-name qualifier
because the qualifier name was not #ZSPI.
Effect. The open attempt failed.
Recovery. Change the qualifier name to #ZSPI and retry the command.
12 Maximum
opens exceeded
Cause. The scheduler exceeded its maximum number of opens (2000).
Effect. The open attempt failed.
Recovery. Try the open again later.
16 File not
opened
Cause. The scheduler rejected the open attempt because it had not yet
completed its own initialization when it received the open request.
Effect. The open attempt failed.
Recovery. Try the open again later.
17 Error on
backup open
Cause. The scheduler rejected an attempted backup open because
there was no matching primary open, the parameters for the backup
open did not match those of the primary open, or the primary process
was not running.
Effect. The open attempt failed.
Recovery. Open the scheduler by specifying its name.
48 Security
violation
Cause. The requester did not have the proper security to communicate
with the scheduler.
Effect. The open attempt failed.
Recovery. Change the application’s security to enable communication
with the scheduler and retry the command.