EMS Manual

EMS Procedures
EMS Manual—426909-005
15-23
EMSTEXT Procedure
Considerations

Because EMSTEXT requires extra data stack space, include this command or its
equivalent in your TAL program:
?EXTENDSTACK 4 ! To ensure enough stack space for
! EMSTEXT

Use the EMSGET procedure to extract information from event messages when it is
feasible to do so, rather than scanning text produced by EMSTEXT. EMSTEXT is
intended specifically for producing text for display purposes.
Table 15-4 lists the status code pairs returned by a function call to EMSTEXT.
If you specify the extended-status parameter, EMSTEXT returns extended status
codes. Use them to analyze and improve the performance of your application rather
than to produce end-user diagnostics.
Table 15-5
lists the EMSTEXT extended status codes. Several refer to information of
which part (or all) is private to HP. If you need help, your service provider can help
solve the problem if you report the exact status code received.
The template file mentioned in Table 15-5 is the file named TEMPLATE in the system
load subvolume. For details, see the DSM Template Services Manual.
Table 15-4. EMSTEXT Status Codes
Status Description
0 0 Normal return
0 22 Bad parameter (address or value); no displayable text
0 29 Required parameter missing; no displayable text
0 632 Insufficient stack space; no displayable text
10 0 Template file problem; or no template and no TEXT token for event; or
EMSTEXT error. For an explanation, see Text Formatting Tools
on page 2-12.
11 0 Bad event buffer. For an explanation, see Text Formatting Tools
on page 2-12.