Command Class

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