DMSRVDELETELOG Function

Deletes a job's log file from a DataFlux Data Management Server.
Valid in: DATA step, PROC SQL, and SCL

Syntax

DMSRVDELETELOG (job-ID, host, port )

Required Arguments

job-ID
identifies the job submitted to a DataFlux Data Management Server. The identifier is set by a function such as DMSRVBATCHJOB.
host
identifies the host of the DataFlux Data Management Server.
Interaction:If a zero-length string is entered for the host argument, then the value localhost will be used.
Example:
        /* Incorrect use of function arguments */
           dmsrvDeleteLog('jobid');

        /* Localhost is used for the host */
           dmsrvDeleteLog('jobid', '', 21036);

        /* Correct */
           dmsrvDeleteLog('jobid', dmsrvhostname, 21036);   
port
identifies the port through which the host communicates with the DataFlux Data Management Server.
Interaction:If the value specified is less than or equal to 0, then port number 21036 is used with SOAP, or port number 21037 is used when using Wireline.
Example:
        /* Incorrect use of function arguments */
           dmsrvDeleteLog('jobid');

        /* Port 21036 or 21037 is used */
           dmsrvDeleteLog('jobid', dmsrvhostname, 0); 

        /* Correct */
           dmsrvDeleteLog('jobid', dmsrvhostname, 21036);   

Details

The log file is created after the job terminates. Use DMSRVJOBSTATUS to ensure that the log file is available for deletion.
  • DMSRVDELETELOG does not delete local copies of the job's log file.
  • Return values are 0 (log deleted successfully) or 1 (log failed to delete).

Example: DMSRVDELETELOG FUNCTION

The following example deletes a log file from a DataFlux Data Management Server. The log file is created when the server runs a job. The job identifier is returned in the function that runs the job.
delrc= dmsrvDeleteLog(jobid,'dmServer1', 5001);