Fetch Name for Next Process

This Subprogram may be used to fetch (retrieve) the Name for all currently defined Processes.

Short Name Calling Sequence

STATUS = UINXPC(INDEX,PRCNAM[,PRCLEN])

Long Name Calling Sequence

STATUS = UI_NEXT_PROCESS(...)

Input Arguments

INDEX (Integer) Process Index (see Notes)

Output Arguments

INDEX (Integer) Process Index (see Notes) PRCNAM (Character) Process Name PRCLEN (Integer) Length of Process Name (Optional)

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_PROCESS ) Illegal Process Name UIILPC )

UI__END_OF_FILE ) Process Scan Completed UIEOF )

Note:

1. The INDEX Argument is used to ``walk" through the currently defined Processes. It should be initialised to a negative number (e.g. -1) and will be setup on return from this Subprogram ready to point to the next Process. The UI__END_OF_FILE Function value signifies that no more Processes exist (i.e. that the Process Scan is complete).
2. The PRCLEN Argument is optional and, if present, will be set to the length of the Process Name following any truncation.