Verbs and Built-in Functions

Summary Table

The following table is a list of the verbs and built-in functions available in Network Control Language, with a brief description of their function.

The Feature/Component column indicates whether a specific product or component must be included in the initialization parameters at region startup before you can use the verb or built-in function.

For more information about the initialization parameters, see the Reference Guide.

Automation Services (AS) is an internal component that is enabled if any of the following products are configured in the region: FT, NETSPY, OPSCICS, OPSOS, SNA, SNAAUTO, TCPIP.

The column headed V/B indicates whether the item is a verb or built-in function.

Name

Description

Feature/ Component

V/B

&AOMALERT

Generates or simulates an AOM event, WTO, VM MSG, or MVS DOM, and routes it as required

AS

V

&AOMCONT

Releases a message from an AOMPROC for delivery, passes the message to another AOMPROC for processing, or sends a copy of the current message to an ISR connected system

AS

V

&AOMDEL

Deletes the message currently being processed by an AOMPROC

AS

V

&AOMFLAG

Alters the value of an AOM global flag

AS

V

&AOMFLAG

Inspects the value of an AOM global flag

AS

B

&AOMGVAR

Alters the value of an AOM global variable

AS

V

&AOMGVAR

Inspects the value of an AOM global variable

AS

B

&AOMINIT

Indicates that the current procedure is to be regarded as an AOMPROC, and registers the procedure for message delivery

AS

V

&AOMMIGID

Determines whether a migration ID is required.

AS

B

&AOMMINLN

Accesses the text of a specific minor line of a multi-line WTO message in an AOMPROC

AS

B

&AOMMINLT

Accesses the line type of a specific minor line of a multi-line WTO message in an AOMPROC

AS

B

&AOMREAD

Requests that the next message be made available to an AOMPROC

AS

V

&AOMREPL

Alters the text of a message and release the message for local delivery

AS

V

&APPC

Provides access to LU6.2 conversations

 

V

&APPSTAT

Returns the current status for a VTAM application

 

B

&ASISTR

Assigns a multi-word string into a variable, retaining leading blanks

 

B

&ASSIGN

Updates lists of variables in one operation

 

V

&BOOLEXPR

Evaluates a Boolean expression

 

B

&CALL procedure

Invokes an NCL procedure

 

V

&CALL program

Invokes a user program

 

V

&CMDLINE

Writes text into your OCS command input line

 

V

&CNMALERT

Sends a CNM record directly to CNMPROC in a local or remote NEWS system for processing

SNA

V

&CNMCLEAR

Requests that all outstanding CNM reply data solicited by this NCL user be cleared

SNA

V

&CNMCONT

Directs the current CNM record across a specific ISR link

SNA

V

&CNMDEL

Deletes a CNM record or stops ISR delivery of the record to a remote region

SNA

V

&CNMPARSE

Requests that the MDO data supplied be parsed into user variables

SNA

V

&CNMREAD

Requests that the next CNM record be made available to an NCL procedure

SNA

V

&CNMSEND

Requests that the data supplied be sent across the CNM interface

SNA

V

&CNMVECTR

Requests that the data supplied be vectored into user variables

SNA

V

&CONCAT

Concatenates multiple variables/constants

 

B

&CONTROL

Sets NCL procedure control characteristics

 

V

&DATECONV

Changes a date format

 

B

&DEC

Converts a hexadecimal number to its decimal equivalent

 

B

&DECODE

Decodes part or all of an MDO

 

V

&DELAY

Interrupts processing of a procedure for a specified period of time

 

V

&DO

Groups a sequence of NCL statements to form a logical program function

 

V

&DOEND

Signifies the logical end of a group of statements

 

V

&DOM

Issues an MVS DOM to cause a non-roll-delete WTO to be erased

 

V

&DOUNTIL

Builds a conditional loop with a test at the bottom

 

V

&DOWHILE

Builds a conditional loop with a test at the top

 

V

&ELSE

The code following the &ELSE verb is the alternative path after &IF, where the &IF condition is false

 

V

&ENCODE

Encodes all or part of an MDO

 

V

&END

Terminates the current nesting level

 

V

&ENDAFTER

Terminates the current nesting level after executing the command following the &ENDAFTER

 

V

&EXIT

Terminates the current nesting level

 

V

&EVENT

Signals an event occurrence

 

V

&FILE

Connects, disconnects, switches, accesses, modifies, and deletes file records

 

V

&FLUSH

Terminates all nesting levels within an NCL process

 

V

&FNDSTR

Determines whether a string occurs within one or more variables

 

V

&GOSUB

Branches to a subroutine within the procedure

 

V

&GOTO

Branches to another statement within the procedure

 

V

&HEX

Converts a decimal number to its hexadecimal equivalent

 

B

&HEXEXP

Converts a character string to its hexadecimal equivalent

 

B

&HEXPACK

Converts a hexadecimal string into equivalent characters

 

V

&IF

Tests the truth of a logical expression

 

V

&INTCLEAR

Clears messages queued to a dependent processing environment

 

V

&INTCMD

Schedules a command to execute in the issuing process's dependent environment

 

V

&INTCONT

Propagates a message to the next higher processing environment

 

V

&INTREAD

Retrieves the next message queued from the issuing process's dependent processing environment

 

V

&INTREPL

Propagates a message to the next higher processing environment, and changes the message text

 

V

&INVSTR

Inverts a string

 

B

&LBLSTR

Removes leading blanks from a string

 

B

&LENGTH

Tells you the length of a variable or constant

 

B

&LOCK

Obtains or releases access to a resource

 

V

&LOGCONT

Resumes normal processing of a message delivered to LOGPROC

 

V

&LOGDEL

Deletes a log record being processed by LOGPROC

 

V

&LOGON

Passes control of a terminal to another application

 

V

&LOGREAD

Makes the next log message available to LOGPROC

 

V

&LOGREPL

Replaces the text of the last log message delivered to LOGPROC

 

V

&LOOPCTL

Sets a new runaway loop control limit

 

V

&MAICMD

Specifies an MAI primary command

SNAACCESS

V

&MAICONT

Sends the current data stream on to the terminal and/or the application

SNAACCESS

V

&MAICURSA

Sets up the cursor address to be sent to the application

SNAACCESS

V

&MAIDEL

Signifies that a data stream is not to be delivered

SNAACCESS

V

&MAIDSFMT

Places the entire current data stream into variables

SNAACCESS

V

&MAIFIND

Determines whether a data stream contains a given string

SNAACCESS

V

&MAIINKEY

Sets the attention key that is to be simulated in a data stream

SNAACCESS

V

&MAIPUT

Builds a data stream to be sent to the PLU (application)

SNAACCESS

V

&MAIREAD

Waits for the next data stream

SNAACCESS

V

&MAIREPL

Replaces a data stream destined for the terminal

SNAACCESS

V

&MAISADD

Adds a new session definition, based on user variables

SNAACCESS

V

&MAISCMD

Specifies an MAI session command against the current session

SNAACCESS

V

&MAISGET

Retrieves details of the specified session into user variables

SNAACCESS

V

&MAISPUT

Updates MAI session list entries

SNAACCESS

V

&MASKCHK

Tests a data string against a wildcard mask

 

B

&MSGCONT

Resumes normal processing of a message delivered to MSGPROC

 

V

&MSGDEL

Deletes a message being processed by MSGPROC

 

V

&MSGREAD

Makes the next message available to MSGPROC

 

V

&MSGREPL

Replaces the text of a message delivered to MSGPROC

 

V

&NBLSTR

Removes leading and trailing blanks from a string

 

B

&NDBADD

Adds a record to an NDB database

 

V

&NDBCLOSE

Signs off (disconnects) from an NDB database

 

V

&NDBCTL

Alters NDB processing characteristics

 

V

&NDBDEF

Adds, updates, or deletes field definitions

 

V

&NDBDEL

Deletes a record from an NDB database

 

V

&NDBFMT

Defines a list of fields to be retrieved by an &NDBGET

 

V

&NDBGET

Retrieves a record from an NDB database

 

V

&NDBINFO

Retrieves information about an NDB database

 

V

&NDBOPEN

Signs on (connects) to an NDB database

 

V

&NDBPHON

Allows you to return a phonetic value for a character string, typically a name

 

V

&NDBQUOTE

Places quotes around data to protect special characters.

 

B

&NDBSCAN

Scans an NDB database for all records matching a search argument

 

V

&NDBSEQ

Defines, deletes, or resets a sequential retrieval path for an NDB database

 

V

&NDBUPD

Updates a record in an NDB database

 

V

&NPFxCHK

Tests a user's network partitioning authority for a resource.

 

B

&NRDDEL

Deletes NRD messages.

 

V

&NUMEDIT

Edits the format of a real number or integer.

 

B

&OVERLAY

Replaces a section of a data string with data from another string

 

B

&PANEL

Displays a full-screen panel

 

V

&PANELEND

Gives up exclusive control of a display window

 

V

&PARSE

Parses tokenized strings into variables

 

V

&PAUSE

Suspends an NCL process

 

V

&PPI

Allows exchange of data between programs

 

V

&PPOALERT

Generates a simulated VTAM PPO message

 

V

&PPOCONT

Resumes normal processing of a VTAM PPO message

 

V

&PPODEL

Deletes a VTAM PPO message, or blocks its delivery

 

V

&PPOREAD

Makes the next VTAM PPO message available to PPOPROC

 

V

&PPOREPL

Resumes normal VTAM PPO message processing, after replacing message text

 

V

&PROMPT

Writes text to a user's terminal and awaits input

 

V

&QEXITR

Terminates this procedure, plus all higher levels

 

V

&REMSTR

Splits a data string and returns the end portion

 

B

&RETCODE

Returns or resets the system return code

 

V

&RETSUB

Returns from a subroutine within a procedure

 

V

&RETURN

Passes variables to a higher nesting level

 

V

&RSCCHECK

Tests a user's access to a resource

 

B

&SECCALL

Communicates with the security subsystem or the installation security exit

 

V

&SELSTR

Splits a data string and returns the front portion

 

B

&SETBLNK

Explicitly sets a variable to blank

 

B

&SETLENG

Sets the length of a variable

 

B

&SETVARS

Extracts named keywords and associated data from a data string

 

V

&SMFWRITE

(z/OS only) Writes a record to the SMF data set

 

V

&SNAMS

Provides the client/server interface to invoke object oriented services

SNA

V

&SOCKET

Provides NCL control over allocation and management of communications using TCP/IP

 

V

&STR

Assigns a multi-word string

 

B

&SUBSTR

Extracts part of a variable or constant

 

B

&TBLSTR

Removes trailing blanks from a string

 

B

&TRANS

Translates characters within a string

 

B

&TYPECHK

Tests variables and returns their type

 

B

&VARTABLE

Creates and maintains vartables and vartable entries

 

V

&WRITE

Writes a message

 

V

&WTO

Issues a WTO

 

V

&WTOR

Issues a WTOR and waits for a reply

 

V

&ZAMCHECK

Indicates whether support is enabled for a specified access method

 

B

&ZFEATURE

Returns availability status of a feature

 

B

&ZNCLKWD

Indicates if string is NCL keyword

 

B

&ZOSCHK

Indicates whether support is enabled for a specified operating system

 

B

&ZPSKIP

Sets new active panel skip data

 

V

&ZQUOTE and &ZQUOTE2

Places quotes around a string

 

B

&ZSHRINK

Removes leading and trailing spaces and reduces multiple spaces within a string

 

B

&ZSOCINFO

Obtains information about the specific socket owned by the process

 

B

&ZSUBST

Returns a string with substituted data

 

B

&ZSYSPARM

Returns the value of a systems parameter (SYSPARMS)

 

B

&ZTCPERDS

Returns a short message for a TCP/IP error code

 

B

&ZTCPERNM

Returns the logical name of a TCP/IP error code

 

B

&ZTCPINFO

Obtains information about the local host or TCP/IP vendor stack

 

B

&ZTCPSUPP

Determines if a function is supported by the current TCP/IP vendor stack

 

B

&ZUNQUOTE

Removes one level of quotes from a string and undoes &ZQUOTE

 

B


Copyright © 2009 CA. All rights reserved.