View source for SplReleaseJob

This function releases a held print job.

== Syntax ==
 SplReleaseJob(pszComputerName, pszQueueName, ulJob)

== Parameters ==
;pszComputerName (PSZ) - input:Name of computer where job is to be continued.
:A NULL string specifies the local workstation.
;pszQueueName (PSZ) - input:Queue Name.
;ulJob (ULONG) - input:Job identification number.

== Returns ==
;rc (SPLERR) - returns:Return code.

:NO_ERROR (0) :No errors occurred.
:ERROR_ACCESS_DENIED (5) :Access is denied.
:ERROR_NOT_SUPPORTED (50) :This request is not supported by the network.
:ERROR_BAD_NETPATH (53) :The network path cannot be located.
:NERR_NetNotStarted (2102) :The network program is not started.
:NERR_JobNotFound (2151) :The print job does not exist.
:NERR_SpoolerNotLoaded (2161) :The spooler is not running.
:NERR_JobInvalidState (2164) :This operation cannot be performed on the print job in its current state.
:NERR_InvalidComputer (2351) :The computer name is invalid.

== Sample ==
This sample code will release the job id that is entered at the prompt.
<pre>
#define INCL_BASE
#define INCL_SPL
#define INCL_SPLERRORS
#include <os2.h>
#include <stdio.h>       /* for printf function */
#include <stdlib.h>      /* for atoi function   */

INT main (argc, argv)
   INT argc;
   CHAR *argv[];
{
   SPLERR splerr ;
   ULONG  ulJob ;
   PSZ    pszComputerName = NULL ;
   PSZ    pszQueueName = NULL ;

   /* Get job id from the input argument  */
   ulJob = atoi(argv[1]);

   /* Call the function to do the release. If an error is returned, print it. */
   splerr=SplReleaseJob( pszComputerName, pszQueueName, ulJob);
   switch (splerr)
   {
   case NO_ERROR:
      printf("Job %d was released.\n",ulJob);
      break;
   case NERR_JobNotFound:
      printf("Job does not exist.\n");
      break;
   case  NERR_JobInvalidState:
      printf("This operation can't be performed on the print Job.\n");
      break;
   default:
      printf("Errorcode = %ld\n",splerr);
   } /* endswitch */
   DosExit( EXIT_PROCESS , 0 ) ;
   argc;
   return (splerr);
}
</pre>

== Call Sequence ==
<pre>
#define INCL_SPL /* Or use INCL_PM, */
#include <os2.h>

PSZ       pszComputerName;  /*  Name of computer where job is to be continued. */
PSZ       pszQueueName;     /*  Queue Name. */
ULONG     ulJob;            /*  Job identification number. */
SPLERR    rc;               /*  Return code. */

rc = SplReleaseJob(pszComputerName, pszQueueName, ulJob);
</pre>

== Remarks ==
Any job can be released by a user with administrator privilege.

A job created locally can be released locally regardless of user privilege level, but it can be released remotely only by a user with administrator privilege.

A remote job can be released by a user without administrator privilege only if the user identification of the person initiating the request is the same as the user identification of the person who created the job.

== Related Functions ==
* [[SplEnumJob]]
* [[SplHoldJob]]
* [[SplQueryJob]]

[[Category:spl]]