catgets

z/OS Using REXX and z/OS UNIX System Services

Previous topic | Next topic | Contents | Contact z/OS | Library | PDF

catgets

z/OS Using REXX and z/OS UNIX System Services
SA23-2283-00


>>-catgets--catalog_descriptor--set_number---------------------->

>--message_number--variable------------------------------------><

Function

catgets locates and returns a message in a message catalog.

Parameters

catalog_descriptor: The catalog descriptor (a number) returned by catopen when a message catalog was opened earlier.
set_number: A number that identifies a message set in the message catalog.
message_number: A number that identifies a message in a message set in the message catalog.
variable: The name of the buffer in which the message string is returned.

Usage notes

Set variable to a default message text prior to invoking the catgets command. If the message identified by message_number is not found, variable is not altered and can be used after the command has been invoked.
If the command is unsuccessful, variable is returned and ERRNO may be set to indicate the error.

Example

"catopen mymsgs.cat"
cd=retval
⋮
msg='error processing request'
"catgets (cd) 1 3 msg"
say msg
⋮
"catclose" cd

Go to the previous page

Go to the next page

Notices | Terms of use | Support | Contact z/OS | zFavorites

Copyright IBM Corporation 1990, 2014