HPlogo SNA NRJE User/Programmer Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 6 NRJE Manager Intrinsics

NRJESendCmd

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

Sends a remote host console command.

Syntax

                    D         LA          I        IA     
 NRJESendCmd ( ConsoleId, CmdBuffer, CmdLength, Result ) 

Parameters

ConsoleId

An input double-word integer variable. The ConsoleId parameter is the remote host console identification. Obtain the value for this parameter by calling NRJEConsole before you call this intrinsic.

CmdBuffer

An input logical array. The CmdBuffer array contains the remote host console command text to be transmitted. The syntax of the command is not checked by NRJE. The text of the command must meet the standards of the host.

A remote host console command can be sent successfully but be in error.

CmdLength

An input integer variable. The CmdLength parameter contains the number of characters in CmdBuffer. The maximum host console command length is 80 characters for all supported host job entry subsystems.

Result

An eight-element integer output array (required). The Result array contains error codes that occurred during execution of this intrinsic.

The first element of the Result array is set to zero if no errors took place. The structure of the Result array is described in "Parameters Common to NRJE Intrinsics" in the introduction to Chapter 5 “User Intrinsics”

Always test the first element of Result immediately after you call this intrinsic. If the first element of Result is not zero, test the other elements of Result to determine the nature of the problem that has occurred.

Description

Obtain the ConsoleId value by calling NRJEConsole first. The CmdBuffer parameter must contain a valid remote host console command for your workstation. The CmdLength parameter must contain the command length in bytes. Use NRJESendCmd with the following intrinsics:

  • NRJERcvMsg: to read one recent remote host console message.

  • NRJEConsCheck: to determine whether any outstanding console messages are waiting to be received.

  • NRJERelease: to relinquish access to the remote host console.

After NRJESendCmd returns control to your program, test the first element of Result.

Text Reference

See the SNA NRJE Node Manager's Guide for a description of "Host Console Commands."

Feedback to webmaster