Maintenance Request API

API Routine: APINMREQ
Parameters: UGNLPARM, UMRLMREQ

The Maintenance Request API allows users to add, modify, purge or display (retrieve) information about a particular maintenance request. The following functions are valid:

A Add Maintenance Request.
D Display Maintenance Request (Retrieve).
M Modify an existing Maintenance Request.
P Purge Maintenance Request.

This document covers the following topics:


Local Data Area UMRLMREQ

The fields to be passed to the API as the second parameter are in the supplied local data area UMRLMREQ. The following is a detailed description of these fields:

Field Name Format Description
REQUEST A20 Name of the maintenance request.
NEW-REQUEST A20 Not currently implemented.
PROBLEM-SUBJECT A60 Problem subject.
PROBLEM-TYPE A8 Problem type.
PRIORITY N3 Priority of the maintenance request.
STATUS A12 Current status of the maintenance request.
ACTION A12 Action to be taken.
CONTACT-NAME A32 Contact name.
CONTACT-TEL A20 Contact telephone number.
CLOSED-TIMX T Date and time maintenance request was closed.
CLOSED-BY A8 User that closed the maintenance request.
CLOSED-TID A8 Terminal that closed the maintenance request.
RELATED-PROB A60 Related problem.
NOTES-1 A60 Notes line 1.
NOTES-2 A60 Notes line 2.
NOTES-3 A60 Notes line 3.
MOD-TIME T Date and time request was last modified.
MOD-BY A8 User that last modified request.
MOD-TID A8 Terminal that last modified request.
ADD-TIME T Date and time request was added.
ADD-BY A8 User that added request.
ADD-TID A8 Terminal that added request.

Maintenance Request API Return Codes

1018 Maintenance Request is locked.
7251 Maintenance Request not found.
7253 Maintenance Request has been added successfully.
7254 Maintenance Request has been modified.
7260 Maintenance Request ID missing.
7561 Maintenance Request Problem Subject missing.
7562 Maintenance Request Priority missing.
7563 Maintenance Request Status missing.
7564 Maintenance Request Status not found.
7565 Maintenance Request Action missing.
7566 Maintenance Request Action not found.
7580 Closed Maintenance Request may not be modified.