The
Command class is provided to allow code in a
non-display file aspx page to invoke functions within a job.
Particularly it enables program calls and the return of
a job to procedural processing.
For a list of all members of this type, see Command Members.
Inheritance Hierarchy
ASNA.Monarch Namespace(ASNA.Monarch.WebDspF.DLL)
Syntax
public class Command
Thread Safety
Any public static (Shared) members of this type are safe for multithreaded operations. Any instance members are not guaranteed to be thread safe.
Remarks
The
Call methods
can invoke an interactive or process program.
Programs called receive parameters by reference, i.e.:
the ASPX code can send and receive data to/from the called
program. These parameters are stored in an array
of strings. The called program can define its
parameters list using fields of type character and decimal
(zoned, packed, binary, and decimal).
Interactive calls also require an ASPX page reference
where control will be relinquished once the called program
finishes execution. Calling interactive programs
effectively means a transfer of control, first to the
interactive program being called and then to the Callback
page reference. Calls that invoke interactive programs can
send data into the program via parameters but the output
parameter list will be sent to the Callback page by storing
the array in the Session under the ["MONARCH_CMDPARM"]
key.
SetLdaField and GetLdaField methods are provided to set and return a value portion of the jobs' LDA while the SetLdcObject, GetLdcObject, and RemoveLdcObject methods are provided to set, return, or remove an entry from the jobs' LDC.
The RequestShutdown method is used to request a shutdown of the job terminating all active programs in the job. The Return method returns the job to procedural processing.
The InvokeQCmdExc method (introduced in 8.0) executes a
command on the IBM i's Job associated with the database connection by calling IBM's QCMDEXC.
See Enhancing Applications using Non-Display File ASPX Pages topic for more information and examples.
Requirements
Namespace: ASNA.Monarch.WebDspF
Assembly: ASNA.Monarch.WebDspF.DLL
Platforms: Windows Server 2012, Windows Server 2012 R2, Windows Server 2016, Windows 7, Windows 8 Pro, Windows 10 Pro