QCHKPNT(1)               Network Queuing Env. 3.3     Last changed: 4-13-98


NNAAMMEE
     qqcchhkkppnntt - Checkpoints an NQS request on a UNICOS, UNICOS/mk, or IRIX
     system

SSYYNNOOPPSSIISS
     qqcchhkkppnntt

IIMMPPLLEEMMEENNTTAATTIIOONN
     IRIX systems

     UNICOS/mk systems

     UNICOS systems

     AIX systems

     Digital UNIX systems

     HP-UX systems

     Solaris systems

DDEESSCCRRIIPPTTIIOONN
     The qqcchhkkppnntt command creates a file that contains all of the necessary
     information to restart the processes associated with a Network Queuing
     System (NQS) request if an unscheduled shutdown occurs.  A scheduled
     NQS shutdown creates a new restart file to replace the restart file
     that the qqcchhkkppnntt command creates.

     The qqcchhkkppnntt command functions only for requests running on a UNICOS or
     UNICOS/mk server.

     Because qqcchhkkppnntt works only from within NQS requests, you must invoke
     it from within the request that is being checkpointed.

     The request continues to run after the checkpoint is complete.

     The NQS administrator can configure automatic checkpoints on the NQS
     server.

EEXXIITT SSTTAATTUUSS
     If the checkpoint succeeds, the exit status is 0.  If the checkpoint
     fails because of a user error, the exit status is 1.  If the
     checkpoint fails because of a system error, the exit status is 2.

EEXXAAMMPPLLEESS
     The following C program fragment causes the NQS request that
     references it to be checkpointed:

       #include <stdio.h>
       #include <errno.h>
       #include <stdlib.h>

       int wait_status;

       if ((wait_status = system("/_n_q_e_b_a_s_e//bbiinn//qqcchhkkppnntt"")))) ==== --11)) {{
            ffpprriinnttff((ssttddeerrrr,, ""ffoorrkk oorr eexxeecc ffaaiilleedd,, eerrrrnnoo == %%dd\\nn"",, eerrrrnnoo));;
            iiff((((eerrrrnnoo>>00))&&&&((eerrrrnnoo<<==ssyyss__nneerrrr))))
                 ffpprriinnttff((ssyysseerrrr,, ""EErrrrnnoo<<%%dd>> == <<%%ss>>\\nn"",, ssyyss__eerrrrlliisstt[[eerrrrnnoo]]));;
            rreettuurrnn((--11));;
       }}

     For the format of the wait status when it is not -1, see wwaaiitt(2).

SSEEEE AALLSSOO
     qqaalltteerr(1), qqddeell(1), qqlliimmiitt(1), qqmmssgg(1), qqssttaatt(1), qqssuubb(1) for
     information on batch request submission

     ccpprr(1) on IRIX 6.4 or later systems for information about checkpoint
     and restart

     cchhkkppnntt(2) for information on whether you can checkpoint a request
     rreessttaarrtt(2) for information on whether you can restart a request
     wwaaiitt(2) for the format of the wait status
     in the _U_N_I_C_O_S _S_y_s_t_e_m _C_a_l_l_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-2012

     nnqqeeiinnffoo(5) for information on the nnqqeeiinnffoo file

     _N_Q_E _U_s_e_r'_s _G_u_i_d_e, publication SG-2148

     _C_h_e_c_k_p_o_i_n_t _a_n_d _R_e_s_t_a_r_t _O_p_e_r_a_t_i_o_n _G_u_i_d_e, Silicon Graphics publication
     007-3236-001

     This man page is available only online.