pbs_confirmresv(3B)

💖 NAME

okay so this is the pbs_confirmresv(3B) page for PBS Professional, and the whole point is: pbs_confirmresv — confirm a PBS reservation ✨ no cap.

🌸 SYNOPSIS

#include <pbs_error.h>
#include <pbs_ifl.h>

int pbs_confirmresv(int connect, char *reservationID, char *location,
                    char *extend)

🦋 DESCRIPTION

Bestie. This function issues a batch request to confirm a PBS advance, standing, or maintenance reservation. It’s giving very official, very reserved, very PBS.

It generates a Confirm Reservation (75) batch request and sends it to the server over the connection specified by connect. Iconic behavior, honestly.

🎀 ARGUMENTS

• connect — this is the return value of pbs_connect(). It specifies the connection over which to send the batch request to the server. Lowkey important.
• reservationID — the reservation to be confirmed. The formats are:
  • advance reservation: R<sequence number>.<server name>
  • standing reservation: S<sequence number>.<server name>
  • maintenance reservation: M<sequence number>.<server name>
• location — a string describing the vnodes and resources to be used for the reservation. The format is:

(<vchunk>)[+(<vchunk>) ...]

where vchunk has the format:

<vnode name>:<vnode resources>[+<vnode name>:<vnode resources> ...]

and where vnode resources has the format:

<resource name>=<value>[:<resource name>=<value> ...]

Example:

-H (VnodeA:mem=100kb:ncpus=1)+
     (VnodeB:mem=100kb:ncpus=2+ VnodeC:mem=100kb)

• start_time — an unsigned long containing the start time in seconds since epoch. It’s used only for ASAP reservations (reservations created by using pbs_ralter -W qmove=<jobID> on an existing job). Keeping this exact, bestie.
• extend — character string for specifying confirmation/non-confirmation action:
  • To confirm a normal reservation, pass in PBS_RESV_CONFIRM_SUCCESS.
  • To have an unconfirmed reservation deleted, pass in PBS_RESV_CONFIRM_FAIL.
  • To have the scheduler set the time when it will try to reconfirm a degraded reservation, pass in PBS_RESV_CONFIRM_FAIL.

Okay so yes, PBS_RESV_CONFIRM_FAIL shows up for both the delete-unconfirmed-reservation move and the let-the-scheduler-set-the-reconfirm-time move. That’s literally what the page says, so don’t come for me 💀.

💅 RETURN VALUE

The routine returns 0 (zero) on success. Slay.

On error, the routine returns a non-zero exit value, and the error number is available in the global integer pbs_errno. So check that global, bestie.

🌈 SEE ALSO

• pbs_rdel(1B)
• pbs_connect(3B)

This page is brought to you by the Local source, dated 15 November 2019, and its manual name is pbs_confirmresv(3B). Mwah 💖