~ubuntu-branches/ubuntu/utopic/gridengine/utopic

<H1>Autodocs for <CODE>Grid Engine Mirror Interface</CODE></H1>This document describes <CODE>Grid Engine Mirror Interface</CODE> version SGE pre6.0 (Maintrunk).

</P><P>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC1">1. Eventmirror</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC2">1.1 --Eventmirror</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC3">1.2 -Eventmirror-Typedefs</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC15">1.7 queue</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC17">1.8 schedd_conf</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC19">1.9 sge_mirror_get_type_descr</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC20">1.10 sge_mirror_get_type_key_nm</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC21">1.11 sge_mirror_get_type_master_list</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC22">1.12 sge_mirror_get_type_name</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC23">1.13 sge_mirror_initialize</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC24">1.14 sge_mirror_process_events</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC25">1.15 sge_mirror_shutdown</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC26">1.16 sge_mirror_strerror</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC27">1.17 sge_mirror_subscribe</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC28">1.18 sge_mirror_unsubscribe</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC29">1.19 sge_mirror_update_master_list</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC30">1.20 sge_mirror_update_master_list_host_key</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC31">1.21 sge_mirror_update_master_list_str_key</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC32">1.22 sharetree</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

</TABLE>

<br>

<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="libmir.html#SEC34">Function Index</A></TD><TD>  </TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>

</TABLE></BLOCKQUOTE>

<P>

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

</TR></TABLE>

<H1> 1. Eventmirror </H1>

<P>

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

100

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

101

102

</TR></TABLE>

103

<H2> 1.1 --Eventmirror </H2>

104

105

<P>

106

107

108

</P><P>

109

110

111

112

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Eventmirror -- mirroring of master lists through event client interface

113

</FONT></pre></td></tr></table><P>

114

115

<DT><B>FUNCTION</B>

116

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>The event mirror interface provides a means to easily implement

117

Grid Engine components that need to have access to the masters

118

object lists and therefore have to mirror them.

119

120

Such components can be schedulers, proxies, monitoring tools etc.

121

122

It is designed as a layer above the event client interface.

123

124

Mirroring can be restricted to certain event types / object types.

125

Callback functions can be installed to perform actions additional to

126

pure mirroring.

127

</FONT></pre></td></tr></table><P>

128

129

130

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Not yet operable on the usermapping related objects and lists.

131

</FONT></pre></td></tr></table><P>

132

133

134

135

<LI>

136

<A HREF="libmir.html#SEC3">1.2 -Eventmirror-Typedefs</A>.

137

<LI>

138

<A HREF="libmir.html#SEC23">1.13 sge_mirror_initialize</A>.

139

<LI>

140

<A HREF="libmir.html#SEC25">1.15 sge_mirror_shutdown</A>.

141

<LI>

142

<A HREF="libmir.html#SEC27">1.17 sge_mirror_subscribe</A>.

143

<LI>

144

<A HREF="libmir.html#SEC28">1.18 sge_mirror_unsubscribe</A>.

145

<LI>

146

<A HREF="libmir.html#SEC24">1.14 sge_mirror_process_events</A>.

147

<LI>

148

<A HREF="libmir.html#SEC29">1.19 sge_mirror_update_master_list</A>.

149

<LI>

150

<A HREF="libmir.html#SEC30">1.20 sge_mirror_update_master_list_host_key</A>.

151

<LI>

152

<A HREF="libmir.html#SEC31">1.21 sge_mirror_update_master_list_str_key</A>.

153

<LI>

154

<A HREF="libmir.html#SEC26">1.16 sge_mirror_strerror</A>.

155

</UL>

156

<P>

157

158

</DL>

159

<P>

160

161

162

163

164

165

166

167

168

169

170

171

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

172

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

173

174

</TR></TABLE>

175

<H2> 1.2 -Eventmirror-Typedefs </H2>

176

177

<P>

178

179

180

</P><P>

181

182

183

184

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Eventmirror -- mirroring of master lists through event client interface

185

</FONT></pre></td></tr></table><P>

186

187

<DT><B>SYNOPSIS</B>

188

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>typedef enum {

189

...

190

} sge_event_type;

191

192

typedef enum {

193

...

194

} sge_event_action;

195

196

typedef enum {

197

...

198

} sge_mirror_error;

199

200

typedef int (*sge_mirror_callback)(sge_event_type type,

201

sge_event_action action,

202

lListElem *event, void *clientdata);

203

204

</FONT></pre></td></tr></table><P>

205

206

<DT><B>FUNCTION</B>

207

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>The following types are defined for use with the event mirroring

208

interface:

209

210

The enumeration sge_event_type defines different classes of events.

211

These classes mostly reflect the different object types defined in

212

libgdi, e.g. job, host, queue ...

213

214

The following event_types are defined:

215

SGE_EMT_ADMINHOST

216

SGE_EMT_CALENDAR

217

SGE_EMT_CKPT

218

SGE_EMT_COMPLEX

219

SGE_EMT_CONFIG

220

SGE_EMT_GLOBAL_CONFIG

221

SGE_EMT_EXECHOST

222

SGE_EMT_JATASK

223

SGE_EMT_PETASK

224

SGE_EMT_JOB

225

SGE_EMT_JOB_SCHEDD_INFO

226

SGE_EMT_MANAGER

227

SGE_EMT_OPERATOR

228

SGE_EMT_SHARETREE

229

SGE_EMT_PE

230

SGE_EMT_PROJECT

231

SGE_EMT_QUEUE

232

SGE_EMT_SCHEDD_CONF

233

SGE_EMT_SCHEDD_MONITOR

234

SGE_EMT_SHUTDOWN

235

SGE_EMT_QMASTER_GOES_DOWN

236

SGE_EMT_SUBMITHOST

237

SGE_EMT_USER

238

SGE_EMT_USERSET

239

240

If usermapping is enabled, two additional event types are defined:

241

SGE_EMT_USERMAPPING

242

SGE_EMT_HOSTGROUP

243

244

The last value defined as event type is SGE_EMT_ALL. It can be used to

245

subscribe all event types.

246

247

Different event actions are defined in the enumeration sge_event_action:

248

SGE_EMA_LIST - the whole master list has been sent

249

(used at initialization)

250

SGE_EMA_ADD - a new object has been created

251

SGE_EMA_MOD - an object has been modified

252

SGE_EMA_DEL - an object has been deleted

253

SGE_EMA_TRIGGER - a certain action has been triggered,

254

e.g. a scheduling run or a shutdown.

255

256

Most functions of the event mirroring interface return error codes that

257

are defined in the enumeration sge_mirror_error:

258

SGE_EM_OK - action performed successfully

259

SGE_EM_NOT_INITIALIZED - the interface is not yet initialized

260

SGE_EM_BAD_ARG - some input parameter was incorrect

261

SGE_EM_TIMEOUT - a timeout occured

262

SGE_EM_DUPLICATE_KEY - an object should be added, but an object

263

with the same unique identifier already

264

exists.

265

SGE_EM_KEY_NOT_FOUND - an object with the given key was not found.

266

SGE_EM_CALLBACK_FAILED - a callback function failed

267

SGE_EM_PROCESS_ERRORS - an error occured during event processing

268

269

The event mirroring interface allows to install callback funktions for

270

actions on certain event types. These callback functions have to have

271

the same prototype as given by the function typedef sge_mirror_callback.

272

</FONT></pre></td></tr></table><P>

273

274

</DL>

275

<P>

276

277

278

279

280

281

282

283

284

285

286

287

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

288

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

289

290

</TR></TABLE>

291

292

293

<P>

294

295

296

297

298

299

300

301

302

303

304

305

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

306

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

307

308

</TR></TABLE>

309

<H3> 1.3.1 host_update_master_list </H3>

310

311

<P>

312

313

314

</P><P>

315

316

317

318

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>host_update_master_list() -- update the master hostlists

319

</FONT></pre></td></tr></table><P>

320

321

<DT><B>SYNOPSIS</B>

322

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>bool

323

host_update_master_list(sge_event_type type, sge_event_action action,

324

lListElem *event, void *clientdata)

325

</FONT></pre></td></tr></table><P>

326

327

<DT><B>FUNCTION</B>

328

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Update the global master lists of hosts

329

based on an event.

330

The function is called from the event mirroring interface.

331

Updates admin, submit or execution host list depending

332

on the event received.

333

</FONT></pre></td></tr></table><P>

334

335

<DT><B>INPUTS</B>

336

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_event_type type - event type

337

sge_event_action action - action to perform

338

lListElem *event - the raw event

339

void *clientdata - client data

340

</FONT></pre></td></tr></table><P>

341

342

<DT><B>RESULT</B>

343

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>bool - true, if update is successfull, else false

344

</FONT></pre></td></tr></table><P>

345

346

<DT><B>NOTES</B>

347

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>The function should only be called from the event mirror interface.

348

</FONT></pre></td></tr></table><P>

349

350

351

352

<LI>

353

<A HREF="libmir.html#SEC2">1.1 --Eventmirror</A>.

354

<LI>

355

<A HREF="libmir.html#SEC29">1.19 sge_mirror_update_master_list</A>.

356

<LI>

357

<A HREF="libmir.html#SEC30">1.20 sge_mirror_update_master_list_host_key</A>.

358

</UL>

359

<P>

360

361

</DL>

362

<P>

363

364

365

366

367

368

369

370

371

372

373

374

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

375

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

376

377

</TR></TABLE>

378

379

380

<P>

381

382

383

384

385

386

387

388

389

390

391

392

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

393

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

394

395

</TR></TABLE>

396

<H3> 1.4.1 ja_task_update_master_list </H3>

397

398

<P>

399

400

401

</P><P>

402

403

404

405

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>ja_task_update_master_list() -- update array tasks of a job

406

</FONT></pre></td></tr></table><P>

407

408

<DT><B>SYNOPSIS</B>

409

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>bool

410

ja_task_update_master_list(sge_event_type type, sge_event_action action,

411

lListElem *event, void *clientdata)

412

</FONT></pre></td></tr></table><P>

413

414

<DT><B>FUNCTION</B>

415

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Update the list of array tasks of a job

416

based on an event.

417

The function is called from the event mirroring interface.

418

419

An array tasks list of parallel tasks and the

420

scaled usage list are not updated in this function,

421

as this data is maintained by separate events.

422

</FONT></pre></td></tr></table><P>

423

424

<DT><B>INPUTS</B>

425

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_event_type type - event type

426

sge_event_action action - action to perform

427

lListElem *event - the raw event

428

void *clientdata - client data

429

</FONT></pre></td></tr></table><P>

430

431

<DT><B>RESULT</B>

432

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>bool - true, if update is successfull, else false

433

</FONT></pre></td></tr></table><P>

434

435

<DT><B>NOTES</B>

436

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>The function should only be called from the event mirror interface.

437

</FONT></pre></td></tr></table><P>

438

439

440

441

<LI>

442

<A HREF="libmir.html#SEC2">1.1 --Eventmirror</A>.

443

<LI>

444

<A HREF="libmir.html#SEC29">1.19 sge_mirror_update_master_list</A>.

445

</UL>

446

<P>

447

448

</DL>

449

450

451

452

453

454

455

456

457

458

459

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

460

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

461

462

</TR></TABLE>

463

<H3> 1.4.2 ja_task_update_master_list_usage </H3>

464

465

<P>

466

467

468

</P><P>

469

470

471

472

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>ja_task_update_master_list_usage() -- update an array tasks usage

473

</FONT></pre></td></tr></table><P>

474

475

<DT><B>SYNOPSIS</B>

476

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>bool

477

ja_task_update_master_list_usage(lListElem *event)

478

</FONT></pre></td></tr></table><P>

479

480

<DT><B>FUNCTION</B>

481

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Updates the scaled usage of an array task (also task data structure

482

of a non array job).

483

</FONT></pre></td></tr></table><P>

484

485

<DT><B>INPUTS</B>

486

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>lListElem *event - event object containing the new usage list

487

</FONT></pre></td></tr></table><P>

488

489

<DT><B>RESULT</B>

490

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>bool - true, if the operation succeeds, else false

491

</FONT></pre></td></tr></table><P>

492

493

494

495

<LI>

496

<A HREF="libmir.html#SEC11">1.5.2 job_update_master_list_usage</A>.

497

<LI>

498

See `<TT>Eventmirror/ja_task/pe_task_update_master_list_usage</TT>'

499

</UL>

500

<P>

501

502

</DL>

503

<P>

504

505

506

507

508

509

510

511

512

513

514

515

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

516

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

517

518

</TR></TABLE>

519

520

521

<P>

522

523

524

525

526

527

528

529

530

531

532

533

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

534

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

535

536

</TR></TABLE>

537

<H3> 1.5.1 job_update_master_list </H3>

538

539

<P>

540

541

542

</P><P>

543

544

545

546

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>job_update_master_list() -- update the master list of jobs

547

</FONT></pre></td></tr></table><P>

548

549

<DT><B>SYNOPSIS</B>

550

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>bool job_update_master_list(sge_event_type type,

551

sge_event_action action,

552

lListElem *event, void *clientdata)

553

</FONT></pre></td></tr></table><P>

554

555

<DT><B>FUNCTION</B>

556

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Update the global master list of jobs

557

based on an event.

558

The function is called from the event mirroring interface.

559

560

A jobs array tasks are not updated by this function,

561

as they are maintained by separate events.

562

In addition, some scheduler specific attributes, that

563

are only used in scheduler, are not updated.

564

</FONT></pre></td></tr></table><P>

565

566

<DT><B>INPUTS</B>

567

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_event_type type - event type

568

sge_event_action action - action to perform

569

lListElem *event - the raw event

570

void *clientdata - client data

571

</FONT></pre></td></tr></table><P>

572

573

<DT><B>RESULT</B>

574

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>bool - true, if update is successfull, else false

575

</FONT></pre></td></tr></table><P>

576

577

<DT><B>NOTES</B>

578

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>The function should only be called from the event mirror interface.

579

</FONT></pre></td></tr></table><P>

580

581

582

583

<LI>

584

<A HREF="libmir.html#SEC2">1.1 --Eventmirror</A>.

585

<LI>

586

<A HREF="libmir.html#SEC29">1.19 sge_mirror_update_master_list</A>.

587

<LI>

588

<A HREF="libmir.html#SEC11">1.5.2 job_update_master_list_usage</A>.

589

</UL>

590

<P>

591

592

</DL>

593

594

595

596

597

598

599

600

601

602

603

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

604

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

605

606

</TR></TABLE>

607

<H3> 1.5.2 job_update_master_list_usage </H3>

608

609

<P>

610

611

612

</P><P>

613

614

615

616

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>job_update_master_list_usage() -- update usage for a jobs tasks

617

</FONT></pre></td></tr></table><P>

618

619

<DT><B>SYNOPSIS</B>

620

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>int job_update_master_list_usage(lListElem *event)

621

</FONT></pre></td></tr></table><P>

622

623

<DT><B>FUNCTION</B>

624

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Events containing usage reports are sent for a jobs tasks.

625

This can be array tasks (where a non array job has a single

626

array task) or tasks of a parallel job.

627

This function decides which type of task has to receive

628

the updated usage report and passes the event

629

information to the corresponding update functions.

630

</FONT></pre></td></tr></table><P>

631

632

<DT><B>INPUTS</B>

633

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>lListElem *event - event object containing the new usage list

634

</FONT></pre></td></tr></table><P>

635

636

<DT><B>RESULT</B>

637

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>int - true, if the operation succeeds, else false

638

</FONT></pre></td></tr></table><P>

639

640

641

642

<LI>

643

See `<TT>Eventmirror/ja_task/pe_task_update_master_list_usage</TT>'

644

<LI>

645

<A HREF="libmir.html#SEC14">1.6.2 pe_task_update_master_list_usage</A>.

646

</UL>

647

<P>

648

649

</DL>

650

<P>

651

652

653

654

655

656

657

658

659

660

661

662

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

663

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

664

665

</TR></TABLE>

666

667

668

<P>

669

670

671

672

673

674

675

676

677

678

679

680

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

681

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

682

683

</TR></TABLE>

684

<H3> 1.6.1 pe_task_update_master_list </H3>

685

686

<P>

687

688

689

</P><P>

690

691

692

693

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>pe_task_update_master_list() -- update parallel tasks of an array task

694

</FONT></pre></td></tr></table><P>

695

696

<DT><B>SYNOPSIS</B>

697

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>bool

698

pe_task_update_master_list(sge_event_type type, sge_event_action action,

699

lListElem *event, void *clientdata)

700

</FONT></pre></td></tr></table><P>

701

702

<DT><B>FUNCTION</B>

703

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Update the list of parallel tasks of an array task

704

based on an event.

705

The function is called from the event mirroring interface.

706

707

The scaled usage list of a parallel task is not updated

708

by this function, as this data is maintained by a

709

separate event.

710

</FONT></pre></td></tr></table><P>

711

712

<DT><B>INPUTS</B>

713

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_event_type type - event type

714

sge_event_action action - action to perform

715

lListElem *event - the raw event

716

void *clientdata - client data

717

</FONT></pre></td></tr></table><P>

718

719

<DT><B>RESULT</B>

720

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>bool - true, if update is successfull, else false

721

</FONT></pre></td></tr></table><P>

722

723

<DT><B>NOTES</B>

724

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>The function should only be called from the event mirror interface.

725

</FONT></pre></td></tr></table><P>

726

727

728

729

<LI>

730

<A HREF="libmir.html#SEC2">1.1 --Eventmirror</A>.

731

<LI>

732

<A HREF="libmir.html#SEC29">1.19 sge_mirror_update_master_list</A>.

733

</UL>

734

<P>

735

736

</DL>

737

738

739

740

741

742

743

744

745

746

747

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

748

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

749

750

</TR></TABLE>

751

<H3> 1.6.2 pe_task_update_master_list_usage </H3>

752

753

<P>

754

755

756

</P><P>

757

758

759

760

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>pe_task_update_master_list_usage() -- update a parallel tasks usage

761

</FONT></pre></td></tr></table><P>

762

763

<DT><B>SYNOPSIS</B>

764

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>bool

765

pe_task_update_master_list_usage(lListElem *event)

766

</FONT></pre></td></tr></table><P>

767

768

<DT><B>FUNCTION</B>

769

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Updates the scaled usage of a parallel task.

770

</FONT></pre></td></tr></table><P>

771

772

<DT><B>INPUTS</B>

773

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>lListElem *event - event object containing the new usage list

774

</FONT></pre></td></tr></table><P>

775

776

<DT><B>RESULT</B>

777

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>bool - true, if the operation succeeds, else false

778

</FONT></pre></td></tr></table><P>

779

780

781

782

<LI>

783

<A HREF="libmir.html#SEC11">1.5.2 job_update_master_list_usage</A>.

784

<LI>

785

<A HREF="libmir.html#SEC8">1.4.2 ja_task_update_master_list_usage</A>.

786

</UL>

787

<P>

788

789

</DL>

790

<P>

791

792

793

794

795

796

797

798

799

800

801

802

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

803

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

804

805

</TR></TABLE>

806

<H2> 1.7 queue </H2>

807

808

<P>

809

810

811

812

813

814

815

816

817

818

819

820

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

821

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

822

823

</TR></TABLE>

824

<H3> 1.7.1 queue_update_master_list </H3>

825

826

<P>

827

828

829

</P><P>

830

831

832

833

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>queue_update_master_list() -- update the master list of queues

834

</FONT></pre></td></tr></table><P>

835

836

<DT><B>SYNOPSIS</B>

837

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>bool

838

queue_update_master_list(sge_event_type type, sge_event_action action,

839

lListElem *event, void *clientdata)

840

</FONT></pre></td></tr></table><P>

841

842

<DT><B>FUNCTION</B>

843

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Update the global master list of queues

844

based on an event.

845

The function is called from the event mirroring interface.

846

</FONT></pre></td></tr></table><P>

847

848

<DT><B>INPUTS</B>

849

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_event_type type - event type

850

sge_event_action action - action to perform

851

lListElem *event - the raw event

852

void *clientdata - client data

853

</FONT></pre></td></tr></table><P>

854

855

<DT><B>RESULT</B>

856

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>int - true, if update is successfull, else false

857

</FONT></pre></td></tr></table><P>

858

859

<DT><B>NOTES</B>

860

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>The function should only be called from the event mirror interface.

861

</FONT></pre></td></tr></table><P>

862

863

864

865

<LI>

866

<A HREF="libmir.html#SEC2">1.1 --Eventmirror</A>.

867

<LI>

868

<A HREF="libmir.html#SEC29">1.19 sge_mirror_update_master_list</A>.

869

<LI>

870

<A HREF="libmir.html#SEC31">1.21 sge_mirror_update_master_list_str_key</A>.

871

</UL>

872

<P>

873

874

</DL>

875

<P>

876

877

878

879

880

881

882

883

884

885

886

887

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

888

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

889

890

</TR></TABLE>

891

<H2> 1.8 schedd_conf </H2>

892

893

<P>

894

895

896

897

898

899

900

901

902

903

904

905

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

906

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

907

908

</TR></TABLE>

909

<H3> 1.8.1 schedd_conf_update_master_list </H3>

910

911

<P>

912

913

914

</P><P>

915

916

917

918

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>schedd_conf_update_master_list() -- update the scheduler configuration

919

</FONT></pre></td></tr></table><P>

920

921

<DT><B>SYNOPSIS</B>

922

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>bool

923

schedd_conf_update_master_list(sge_event_type type,

924

sge_event_action action,

925

lListElem *event, void *clientdata)

926

</FONT></pre></td></tr></table><P>

927

928

<DT><B>FUNCTION</B>

929

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Update the global master list of scheduler configurations

930

based on an event.

931

The function is called from the event mirroring interface.

932

The list only contains one element that is replaced when a

933

modify event arrives.

934

</FONT></pre></td></tr></table><P>

935

936

<DT><B>INPUTS</B>

937

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_event_type type - event type

938

sge_event_action action - action to perform

939

lListElem *event - the raw event

940

void *clientdata - client data

941

</FONT></pre></td></tr></table><P>

942

943

<DT><B>RESULT</B>

944

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>bool - true, if update is successfull, else false

945

</FONT></pre></td></tr></table><P>

946

947

<DT><B>NOTES</B>

948

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>The function should only be called from the event mirror interface.

949

</FONT></pre></td></tr></table><P>

950

951

952

953

<LI>

954

<A HREF="libmir.html#SEC2">1.1 --Eventmirror</A>.

955

</UL>

956

<P>

957

958

</DL>

959

<P>

960

961

962

963

964

965

966

967

968

969

970

971

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

972

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

973

974

</TR></TABLE>

975

<H2> 1.9 sge_mirror_get_type_descr </H2>

976

977

<P>

978

979

980

</P><P>

981

982

983

984

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_get_type_descr() -- get the descriptor for an event type

985

</FONT></pre></td></tr></table><P>

986

987

<DT><B>SYNOPSIS</B>

988

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>const lDescr* sge_mirror_get_type_descr(const sge_event_type type)

989

</FONT></pre></td></tr></table><P>

990

991

<DT><B>FUNCTION</B>

992

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Returns the CULL element descriptor for the object type associated with

993

the given event.

994

</FONT></pre></td></tr></table><P>

995

996

<DT><B>INPUTS</B>

997

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>const sge_event_type type - the event type

998

</FONT></pre></td></tr></table><P>

999

1000

<DT><B>RESULT</B>

1001

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>const lDescr* - the descriptor, or NULL, if no descriptor is associated

1002

with the type

1003

</FONT></pre></td></tr></table><P>

1004

1005

<DT><B>EXAMPLE</B>

1006

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_get_type_descr(SGE_EMT_JOB) will return the descriptor JB_Type,

1007

sge_mirror_get_type_descr(SGE_EMT_SHUTDOWN) will return NULL

1008

</FONT></pre></td></tr></table><P>

1009

1010

1011

1012

<LI>

1013

<A HREF="libmir.html#SEC21">1.11 sge_mirror_get_type_master_list</A>.

1014

<LI>

1015

<A HREF="libmir.html#SEC22">1.12 sge_mirror_get_type_name</A>.

1016

<LI>

1017

<A HREF="libmir.html#SEC20">1.10 sge_mirror_get_type_key_nm</A>.

1018

</UL>

1019

<P>

1020

1021

</DL>

1022

<P>

1023

1024

1025

1026

1027

1028

1029

1030

1031

1032

1033

1034

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

1035

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

1036

1037

</TR></TABLE>

1038

<H2> 1.10 sge_mirror_get_type_key_nm </H2>

1039

1040

<P>

1041

1042

1043

</P><P>

1044

1045

1046

1047

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_get_type_key_nm() -- get the primary key attribute for a type

1048

</FONT></pre></td></tr></table><P>

1049

1050

<DT><B>SYNOPSIS</B>

1051

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>int sge_mirror_get_type_key_nm(const sge_event_type type)

1052

</FONT></pre></td></tr></table><P>

1053

1054

<DT><B>FUNCTION</B>

1055

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Returns the primary key attribute for the object type associated with

1056

the given event type.

1057

</FONT></pre></td></tr></table><P>

1058

1059

<DT><B>INPUTS</B>

1060

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>const sge_event_type type - event type

1061

</FONT></pre></td></tr></table><P>

1062

1063

<DT><B>RESULT</B>

1064

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>int - the key number (struct element nm of the descriptor), or

1065

-1, if no object type is associated with the event type

1066

</FONT></pre></td></tr></table><P>

1067

1068

<DT><B>EXAMPLE</B>

1069

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_get_type_key_nm(SGE_EMT_JOB) will return JB_job_number

1070

sge_mirror_get_type_key_nm(SGE_EMT_SHUTDOWN) will return -1

1071

</FONT></pre></td></tr></table><P>

1072

1073

1074

1075

<LI>

1076

<A HREF="libmir.html#SEC21">1.11 sge_mirror_get_type_master_list</A>.

1077

<LI>

1078

<A HREF="libmir.html#SEC22">1.12 sge_mirror_get_type_name</A>.

1079

<LI>

1080

<A HREF="libmir.html#SEC19">1.9 sge_mirror_get_type_descr</A>.

1081

</UL>

1082

<P>

1083

1084

</DL>

1085

<P>

1086

1087

1088

1089

1090

1091

1092

1093

1094

1095

1096

1097

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

1098

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

1099

1100

</TR></TABLE>

1101

<H2> 1.11 sge_mirror_get_type_master_list </H2>

1102

1103

<P>

1104

1105

1106

</P><P>

1107

1108

1109

1110

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_get_type_master_list() -- get master list for an event type

1111

</FONT></pre></td></tr></table><P>

1112

1113

<DT><B>SYNOPSIS</B>

1114

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>lList** sge_mirror_get_type_master_list(const sge_event_type type)

1115

</FONT></pre></td></tr></table><P>

1116

1117

<DT><B>FUNCTION</B>

1118

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Returns a pointer to the master list holding objects that are manipulated

1119

by events of the given type.

1120

</FONT></pre></td></tr></table><P>

1121

1122

<DT><B>INPUTS</B>

1123

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>const sge_event_type type - the event type

1124

</FONT></pre></td></tr></table><P>

1125

1126

<DT><B>RESULT</B>

1127

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>lList** - the corresponding master list, or NULL, if the event type has no

1128

associated master list

1129

</FONT></pre></td></tr></table><P>

1130

1131

<DT><B>EXAMPLE</B>

1132

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_get_type_master_list(SGE_EMT_JOB) will return a pointer to the

1133

Master_Job_List.

1134

1135

sge_mirror_get_type_master_list(SGE_EMT_SHUTDOWN) will return NULL,

1136

as this event type has no associated master list.

1137

</FONT></pre></td></tr></table><P>

1138

1139

<DT><B>NOTES</B>

1140

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>This and the following utility functions should be moved to some more

1141

general object type handling.

1142

</FONT></pre></td></tr></table><P>

1143

1144

1145

1146

<LI>

1147

<A HREF="libmir.html#SEC21">1.11 sge_mirror_get_type_master_list</A>.

1148

<LI>

1149

<A HREF="libmir.html#SEC22">1.12 sge_mirror_get_type_name</A>.

1150

<LI>

1151

<A HREF="libmir.html#SEC19">1.9 sge_mirror_get_type_descr</A>.

1152

<LI>

1153

<A HREF="libmir.html#SEC20">1.10 sge_mirror_get_type_key_nm</A>.

1154

</UL>

1155

<P>

1156

1157

</DL>

1158

<P>

1159

1160

1161

1162

1163

1164

1165

1166

1167

1168

1169

1170

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

1171

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

1172

1173

</TR></TABLE>

1174

<H2> 1.12 sge_mirror_get_type_name </H2>

1175

1176

<P>

1177

1178

1179

</P><P>

1180

1181

1182

1183

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_get_type_name() -- get a printable name for an event type

1184

</FONT></pre></td></tr></table><P>

1185

1186

<DT><B>SYNOPSIS</B>

1187

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>const char* sge_mirror_get_type_name(const sge_event_type type)

1188

</FONT></pre></td></tr></table><P>

1189

1190

<DT><B>FUNCTION</B>

1191

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Returns a printable name for an event type.

1192

</FONT></pre></td></tr></table><P>

1193

1194

<DT><B>INPUTS</B>

1195

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>const sge_event_type type - the event type

1196

</FONT></pre></td></tr></table><P>

1197

1198

<DT><B>RESULT</B>

1199

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>const char* - string describing the type

1200

</FONT></pre></td></tr></table><P>

1201

1202

<DT><B>EXAMPLE</B>

1203

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_get_type_name(SGE_EMT_JOB) will return "JOB"

1204

</FONT></pre></td></tr></table><P>

1205

1206

1207

1208

<LI>

1209

<A HREF="libmir.html#SEC21">1.11 sge_mirror_get_type_master_list</A>.

1210

<LI>

1211

<A HREF="libmir.html#SEC19">1.9 sge_mirror_get_type_descr</A>.

1212

<LI>

1213

<A HREF="libmir.html#SEC20">1.10 sge_mirror_get_type_key_nm</A>.

1214

</UL>

1215

<P>

1216

1217

</DL>

1218

<P>

1219

1220

1221

1222

1223

1224

1225

1226

1227

1228

1229

1230

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

1231

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

1232

1233

</TR></TABLE>

1234

<H2> 1.13 sge_mirror_initialize </H2>

1235

1236

<P>

1237

1238

1239

</P><P>

1240

1241

1242

1243

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_initialize() -- initialize the event mirror interface

1244

</FONT></pre></td></tr></table><P>

1245

1246

<DT><B>SYNOPSIS</B>

1247

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_error sge_mirror_initialize(ev_registration_id id,

1248

const char *name)

1249

</FONT></pre></td></tr></table><P>

1250

1251

<DT><B>FUNCTION</B>

1252

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Initializes internal data structures and registers with qmaster

1253

using the event client mechanisms.

1254

1255

Events covering shutdown requests and qmaster shutdown notification

1256

are subscribed.

1257

1258

</FONT></pre></td></tr></table><P>

1259

1260

<DT><B>INPUTS</B>

1261

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>ev_registration_id id - id used to register with qmaster

1262

const char *name - name used to register with qmaster

1263

</FONT></pre></td></tr></table><P>

1264

1265

<DT><B>RESULT</B>

1266

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_error - SGE_EM_OK or an error code

1267

</FONT></pre></td></tr></table><P>

1268

1269

1270

1271

<LI>

1272

<A HREF="libmir.html#SEC25">1.15 sge_mirror_shutdown</A>.

1273

<LI>

1274

See `<TT>Eventclient/-ID-numbers</TT>'

1275

</UL>

1276

<P>

1277

1278

</DL>

1279

<P>

1280

1281

1282

1283

1284

1285

1286

1287

1288

1289

1290

1291

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

1292

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

1293

1294

</TR></TABLE>

1295

<H2> 1.14 sge_mirror_process_events </H2>

1296

1297

<P>

1298

1299

1300

</P><P>

1301

1302

1303

1304

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_process_events() -- retrieve and process events

1305

</FONT></pre></td></tr></table><P>

1306

1307

<DT><B>SYNOPSIS</B>

1308

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_error sge_mirror_process_events(void)

1309

</FONT></pre></td></tr></table><P>

1310

1311

<DT><B>FUNCTION</B>

1312

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Retrieves new events from qmaster.

1313

If new events have arrived from qmaster, they are processed,

1314

that means, for each event

1315

- if installed, a "before mirroring" callback is called

1316

- the event is mirrored into the corresponding master list

1317

- if installed, a "after mirroring" callback is called

1318

1319

If retrieving new events from qmaster fails over a time period

1320

of 10 times the configured event delivery interval (see event

1321

client interface, function ec_get_edtime), a timeout warning

1322

is generated and a new registration of the event client is

1323

prepared.

1324

</FONT></pre></td></tr></table><P>

1325

1326

<DT><B>RESULT</B>

1327

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_error - SGE_EM_OK or an error code

1328

</FONT></pre></td></tr></table><P>

1329

1330

1331

1332

<LI>

1333

<A HREF="libmir.html#SEC2">1.1 --Eventmirror</A>.

1334

<LI>

1335

See `<TT>Eventclient/Client/ec_get_edtime</TT>'

1336

<LI>

1337

See `<TT>Eventclient/Client/ec_set_edtime</TT>'

1338

</UL>

1339

<P>

1340

1341

</DL>

1342

<P>

1343

1344

1345

1346

1347

1348

1349

1350

1351

1352

1353

1354

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

1355

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

1356

1357

</TR></TABLE>

1358

<H2> 1.15 sge_mirror_shutdown </H2>

1359

1360

<P>

1361

1362

1363

</P><P>

1364

1365

1366

1367

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_shutdown() -- shutdown mirroring

1368

</FONT></pre></td></tr></table><P>

1369

1370

<DT><B>SYNOPSIS</B>

1371

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_error sge_mirror_shutdown(void)

1372

</FONT></pre></td></tr></table><P>

1373

1374

<DT><B>FUNCTION</B>

1375

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Shuts down the event mirroring mechanism:

1376

Unsubscribes all events, deletes contents of the corresponding

1377

object lists and deregisteres from qmaster.

1378

</FONT></pre></td></tr></table><P>

1379

1380

<DT><B>RESULT</B>

1381

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_error - SGE_EM_OK or error code

1382

</FONT></pre></td></tr></table><P>

1383

1384

1385

1386

<LI>

1387

<A HREF="libmir.html#SEC23">1.13 sge_mirror_initialize</A>.

1388

</UL>

1389

<P>

1390

1391

</DL>

1392

<P>

1393

1394

1395

1396

1397

1398

1399

1400

1401

1402

1403

1404

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

1405

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

1406

1407

</TR></TABLE>

1408

<H2> 1.16 sge_mirror_strerror </H2>

1409

1410

<P>

1411

1412

1413

</P><P>

1414

1415

1416

1417

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_strerror() -- map errorcode to error message

1418

</FONT></pre></td></tr></table><P>

1419

1420

<DT><B>SYNOPSIS</B>

1421

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>const char* sge_mirror_strerror(sge_mirror_error num)

1422

</FONT></pre></td></tr></table><P>

1423

1424

<DT><B>FUNCTION</B>

1425

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Returns a string describing a given error number.

1426

This function can be used to output error messages

1427

if a function of the event mirror interface fails.

1428

</FONT></pre></td></tr></table><P>

1429

1430

<DT><B>INPUTS</B>

1431

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_error num - error number

1432

</FONT></pre></td></tr></table><P>

1433

1434

<DT><B>RESULT</B>

1435

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>const char* - corresponding error message

1436

</FONT></pre></td></tr></table><P>

1437

1438

1439

1440

<LI>

1441

<A HREF="libmir.html#SEC3">1.2 -Eventmirror-Typedefs</A>.

1442

</UL>

1443

<P>

1444

1445

</DL>

1446

<P>

1447

1448

1449

1450

1451

1452

1453

1454

1455

1456

1457

1458

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

1459

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

1460

1461

</TR></TABLE>

1462

<H2> 1.17 sge_mirror_subscribe </H2>

1463

1464

<P>

1465

1466

1467

</P><P>

1468

1469

1470

1471

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_subscribe() -- subscribe certain event types

1472

</FONT></pre></td></tr></table><P>

1473

1474

<DT><B>SYNOPSIS</B>

1475

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_error sge_mirror_subscribe(sge_event_type type,

1476

sge_mirror_callback callback_before,

1477

sge_mirror_callback callback_after,

1478

void *clientdata)

1479

</FONT></pre></td></tr></table><P>

1480

1481

<DT><B>FUNCTION</B>

1482

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Subscribe a certain event type.

1483

Callback functions can be specified, that can be executed before the

1484

mirroring action and/or after the mirroring action.

1485

1486

The corresponding data structures are initialized,

1487

the events associated with the event type are subscribed with the

1488

event client interface.

1489

</FONT></pre></td></tr></table><P>

1490

1491

<DT><B>INPUTS</B>

1492

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_event_type type - event type to subscribe or

1493

SGE_EMT_ALL

1494

sge_mirror_callback callback_before - callback to be executed before

1495

mirroring

1496

sge_mirror_callback callback_after - callback to be executed after

1497

mirroring

1498

void *clientdata - clientdata to be passed to the

1499

callback functions

1500

</FONT></pre></td></tr></table><P>

1501

1502

<DT><B>RESULT</B>

1503

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_error - SGE_EM_OK or an error code

1504

</FONT></pre></td></tr></table><P>

1505

1506

1507

1508

<LI>

1509

<A HREF="libmir.html#SEC3">1.2 -Eventmirror-Typedefs</A>.

1510

<LI>

1511

See `<TT>Eventclient/-Subscription</TT>'

1512

<LI>

1513

See `<TT>Eventclient/-Events</TT>'

1514

<LI>

1515

<A HREF="libmir.html#SEC28">1.18 sge_mirror_unsubscribe</A>.

1516

</UL>

1517

<P>

1518

1519

</DL>

1520

<P>

1521

1522

1523

1524

1525

1526

1527

1528

1529

1530

1531

1532

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

1533

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

1534

1535

</TR></TABLE>

1536

<H2> 1.18 sge_mirror_unsubscribe </H2>

1537

1538

<P>

1539

1540

1541

</P><P>

1542

1543

1544

1545

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_unsubscribe() -- unsubscribe event types

1546

</FONT></pre></td></tr></table><P>

1547

1548

<DT><B>SYNOPSIS</B>

1549

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_error sge_mirror_unsubscribe(sge_event_type type)

1550

</FONT></pre></td></tr></table><P>

1551

1552

<DT><B>FUNCTION</B>

1553

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Unsubscribes a certain event type or all if SGE_EMT_ALL is given as type.

1554

1555

Unsubscribes the corresponding events in the underlying event client

1556

interface and frees data stored in the corresponding mirrored list(s).@end smallexample

1557

1558

<DT><B>INPUTS</B>

1559

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_event_type type - the event type to unsubscribe or SGE_EMT_ALL

1560

</FONT></pre></td></tr></table><P>

1561

1562

<DT><B>RESULT</B>

1563

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_error - SGE_EM_OK or an error code

1564

</FONT></pre></td></tr></table><P>

1565

1566

1567

1568

<LI>

1569

<A HREF="libmir.html#SEC3">1.2 -Eventmirror-Typedefs</A>.

1570

<LI>

1571

See `<TT>Eventclient/-Subscription</TT>'

1572

<LI>

1573

See `<TT>Eventclient/-Events</TT>'

1574

<LI>

1575

<A HREF="libmir.html#SEC27">1.17 sge_mirror_subscribe</A>.

1576

</UL>

1577

<P>

1578

1579

</DL>

1580

<P>

1581

1582

1583

1584

1585

1586

1587

1588

1589

1590

1591

1592

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

1593

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

1594

1595

</TR></TABLE>

1596

<H2> 1.19 sge_mirror_update_master_list </H2>

1597

1598

<P>

1599

1600

1601

</P><P>

1602

1603

1604

1605

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_update_master_list() -- update a master list

1606

</FONT></pre></td></tr></table><P>

1607

1608

<DT><B>SYNOPSIS</B>

1609

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_error sge_mirror_update_master_list(lList **list,

1610

lDescr *list_descr,

1611

lListElem *ep,

1612

const char *key,

1613

sge_event_action action,

1614

lListElem *event)

1615

</FONT></pre></td></tr></table><P>

1616

1617

<DT><B>FUNCTION</B>

1618

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Updates a given master list according to the given event information.

1619

The following actions are performed (depending on parameter action):

1620

- SGE_EMA_LIST: an existing mirrored list is completely replaced

1621

- SGE_EMA_ADD: a new element is added to the mirrored list

1622

- SGE_EMA_MOD: a given element is modified

1623

- SGE_EMA_DEL: a given element is deleted

1624

</FONT></pre></td></tr></table><P>

1625

1626

<DT><B>INPUTS</B>

1627

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>lList **list - mirrored list to manipulate

1628

lDescr *list_descr - descriptor of mirrored list

1629

lListElem *ep - element to manipulate or NULL

1630

const char *key - key of an element to manipulate

1631

sge_event_action action - action to perform

1632

lListElem *event - raw event

1633

</FONT></pre></td></tr></table><P>

1634

1635

<DT><B>RESULT</B>

1636

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_error - SGE_EM_OK, or an error code

1637

</FONT></pre></td></tr></table><P>

1638

1639

1640

1641

<LI>

1642

<A HREF="libmir.html#SEC31">1.21 sge_mirror_update_master_list_str_key</A>.

1643

<LI>

1644

<A HREF="libmir.html#SEC30">1.20 sge_mirror_update_master_list_host_key</A>.

1645

</UL>

1646

<P>

1647

1648

</DL>

1649

<P>

1650

1651

1652

1653

1654

1655

1656

1657

1658

1659

1660

1661

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

1662

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

1663

1664

</TR></TABLE>

1665

<H2> 1.20 sge_mirror_update_master_list_host_key </H2>

1666

1667

<P>

1668

1669

1670

</P><P>

1671

1672

1673

1674

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_update_master_list_host_key() -- update a master list

1675

</FONT></pre></td></tr></table><P>

1676

1677

<DT><B>SYNOPSIS</B>

1678

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_error sge_mirror_update_master_list_host_key(lList **list,

1679

lDescr *list_descr,

1680

int key_nm,

1681

const char *key,

1682

sge_event_action action,

1683

lListElem *event)

1684

</FONT></pre></td></tr></table><P>

1685

1686

<DT><B>FUNCTION</B>

1687

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Updates a certain element in a certain mirrored list.

1688

Which element to update is specified by a given hostname.

1689

</FONT></pre></td></tr></table><P>

1690

1691

<DT><B>INPUTS</B>

1692

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>lList **list - the master list to update

1693

lDescr *list_descr - descriptor of the master list

1694

int key_nm - field identifier of the key

1695

const char *key - value of the key (a hostname)

1696

sge_event_action action - action to perform on list

1697

lListElem *event - raw event element

1698

</FONT></pre></td></tr></table><P>

1699

1700

<DT><B>RESULT</B>

1701

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_error - SGE_EM_OK or an error code

1702

</FONT></pre></td></tr></table><P>

1703

1704

1705

1706

<LI>

1707

<A HREF="libmir.html#SEC29">1.19 sge_mirror_update_master_list</A>.

1708

</UL>

1709

<P>

1710

1711

</DL>

1712

<P>

1713

1714

1715

1716

1717

1718

1719

1720

1721

1722

1723

1724

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

1725

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

1726

1727

</TR></TABLE>

1728

<H2> 1.21 sge_mirror_update_master_list_str_key </H2>

1729

1730

<P>

1731

1732

1733

</P><P>

1734

1735

1736

1737

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_update_master_list_str_key() -- update a master list

1738

</FONT></pre></td></tr></table><P>

1739

1740

<DT><B>SYNOPSIS</B>

1741

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_error sge_mirror_update_master_list_str_key(lList **list,

1742

lDescr *list_descr,

1743

int key_nm,

1744

const char *key,

1745

sge_event_action action,

1746

lListElem *event)

1747

</FONT></pre></td></tr></table><P>

1748

1749

<DT><B>FUNCTION</B>

1750

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Updates a certain element in a certain mirrored list.

1751

Which element to update is specified by a given string key.

1752

</FONT></pre></td></tr></table><P>

1753

1754

<DT><B>INPUTS</B>

1755

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>lList **list - the master list to update

1756

lDescr *list_descr - descriptor of the master list

1757

int key_nm - field identifier of the key

1758

const char *key - value of the key

1759

sge_event_action action - action to perform on list

1760

lListElem *event - raw event element

1761

</FONT></pre></td></tr></table><P>

1762

1763

<DT><B>RESULT</B>

1764

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_mirror_error - SGE_EM_OK or an error code

1765

</FONT></pre></td></tr></table><P>

1766

1767

1768

1769

<LI>

1770

<A HREF="libmir.html#SEC29">1.19 sge_mirror_update_master_list</A>.

1771

</UL>

1772

<P>

1773

1774

</DL>

1775

<P>

1776

1777

1778

1779

1780

1781

1782

1783

1784

1785

1786

1787

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

1788

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

1789

1790

</TR></TABLE>

1791

<H2> 1.22 sharetree </H2>

1792

1793

<P>

1794

1795

1796

1797

1798

1799

1800

1801

1802

1803

1804

1805

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

1806

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

1807

1808

</TR></TABLE>

1809

<H3> 1.22.1 sharetree_update_master_list </H3>

1810

1811

<P>

1812

1813

1814

</P><P>

1815

1816

1817

1818

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sharetree_update_master_list() -- update the master sharetree list

1819

</FONT></pre></td></tr></table><P>

1820

1821

<DT><B>SYNOPSIS</B>

1822

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>bool

1823

sharetree_update_master_list(sge_event_type type, sge_event_action action,

1824

lListElem *event, void *clientdata)

1825

</FONT></pre></td></tr></table><P>

1826

1827

<DT><B>FUNCTION</B>

1828

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>Update the global master list for the sharetree

1829

based on an event.

1830

The function is called from the event mirroring interface.

1831

Sharetree events always contain the whole sharetree, that

1832

replaces an existing sharetree in the master list.

1833

</FONT></pre></td></tr></table><P>

1834

1835

<DT><B>INPUTS</B>

1836

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>sge_event_type type - event type

1837

sge_event_action action - action to perform

1838

lListElem *event - the raw event

1839

void *clientdata - client data

1840

</FONT></pre></td></tr></table><P>

1841

1842

<DT><B>RESULT</B>

1843

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>bool - true, if update is successfull, else false

1844

</FONT></pre></td></tr></table><P>

1845

1846

<DT><B>NOTES</B>

1847

<DD><TABLE><tr><td> </td><td class=smallexample><FONT SIZE=-1><pre>The function should only be called from the event mirror interface.

1848

</FONT></pre></td></tr></table><P>

1849

1850

1851

1852

<LI>

1853

<A HREF="libmir.html#SEC2">1.1 --Eventmirror</A>.

1854

</UL>

1855

<P>

1856

1857

</DL>

1858

1859

1860

1861

1862

1863

1864

1865

1866

1867

1868

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

1869

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

1870

1871

</TR></TABLE>

1872

<H1> Function Index </H1>

1873

1874

1875

1876

<BR>

1877

1878

1879

1880

1881

1882

1883

1884

1885

1886

1887

</td></tr></table><br><P></P>

1888

1889

<TR><TD></TD><TH ALIGN=LEFT>Index Entry</TH><TH ALIGN=LEFT> Section</TH></TR>

1890

1891

1892

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX1"><CODE>--Eventmirror</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC2">1.1 --Eventmirror</A></TD></TR>

1893

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX2"><CODE>-Eventmirror-Typedefs</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC3">1.2 -Eventmirror-Typedefs</A></TD></TR>

1894

1895

1896

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX3"><CODE>host_update_master_list</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC5">1.3.1 host_update_master_list</A></TD></TR>

1897

1898

1899

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX4"><CODE>ja_task_update_master_list</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC7">1.4.1 ja_task_update_master_list</A></TD></TR>

1900

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX5"><CODE>ja_task_update_master_list_usage</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC8">1.4.2 ja_task_update_master_list_usage</A></TD></TR>

1901

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX6"><CODE>job_update_master_list</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC10">1.5.1 job_update_master_list</A></TD></TR>

1902

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX7"><CODE>job_update_master_list_usage</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC11">1.5.2 job_update_master_list_usage</A></TD></TR>

1903

1904

1905

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX8"><CODE>pe_task_update_master_list</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC13">1.6.1 pe_task_update_master_list</A></TD></TR>

1906

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX9"><CODE>pe_task_update_master_list_usage</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC14">1.6.2 pe_task_update_master_list_usage</A></TD></TR>

1907

1908

1909

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX10"><CODE>queue_update_master_list</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC16">1.7.1 queue_update_master_list</A></TD></TR>

1910

1911

1912

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX11"><CODE>schedd_conf_update_master_list</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC18">1.8.1 schedd_conf_update_master_list</A></TD></TR>

1913

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX12"><CODE>sge_mirror_get_type_descr</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC19">1.9 sge_mirror_get_type_descr</A></TD></TR>

1914

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX13"><CODE>sge_mirror_get_type_key_nm</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC20">1.10 sge_mirror_get_type_key_nm</A></TD></TR>

1915

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX14"><CODE>sge_mirror_get_type_master_list</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC21">1.11 sge_mirror_get_type_master_list</A></TD></TR>

1916

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX15"><CODE>sge_mirror_get_type_name</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC22">1.12 sge_mirror_get_type_name</A></TD></TR>

1917

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX16"><CODE>sge_mirror_initialize</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC23">1.13 sge_mirror_initialize</A></TD></TR>

1918

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX17"><CODE>sge_mirror_process_events</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC24">1.14 sge_mirror_process_events</A></TD></TR>

1919

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX18"><CODE>sge_mirror_shutdown</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC25">1.15 sge_mirror_shutdown</A></TD></TR>

1920

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX19"><CODE>sge_mirror_strerror</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC26">1.16 sge_mirror_strerror</A></TD></TR>

1921

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX20"><CODE>sge_mirror_subscribe</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC27">1.17 sge_mirror_subscribe</A></TD></TR>

1922

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX21"><CODE>sge_mirror_unsubscribe</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC28">1.18 sge_mirror_unsubscribe</A></TD></TR>

1923

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX22"><CODE>sge_mirror_update_master_list</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC29">1.19 sge_mirror_update_master_list</A></TD></TR>

1924

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX23"><CODE>sge_mirror_update_master_list_host_key</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC30">1.20 sge_mirror_update_master_list_host_key</A></TD></TR>

1925

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX24"><CODE>sge_mirror_update_master_list_str_key</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC31">1.21 sge_mirror_update_master_list_str_key</A></TD></TR>

1926

<TR><TD></TD><TD valign=top><A HREF="libmir.html#IDX25"><CODE>sharetree_update_master_list</CODE></A></TD><TD valign=top><A HREF="libmir.html#SEC33">1.22.1 sharetree_update_master_list</A></TD></TR>

1927

1928

</TABLE><P></P><table><tr><th valign=top>Jump to:   </th><td><A HREF="libmir.html#fn_-" style="text-decoration:none"><b>-</b></A>

1929

1930

<BR>

1931

1932

1933

1934

1935

1936

1937

1938

1939

1940

1941

</td></tr></table><br><P>

1942

1943

1944

1945

1946

1947

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

1948

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

1949

1950

</TR></TABLE>

1951

<H1>Table of Contents</H1>

1952

1953

<A NAME="TOC1" HREF="libmir.html#SEC1">1. Eventmirror</A>

1954

<BR>

1955

1956

<A NAME="TOC2" HREF="libmir.html#SEC2">1.1 --Eventmirror</A>

1957

<BR>

1958

<A NAME="TOC3" HREF="libmir.html#SEC3">1.2 -Eventmirror-Typedefs</A>

1959

<BR>

1960

1961

<BR>

1962

1963

<A NAME="TOC5" HREF="libmir.html#SEC5">1.3.1 host_update_master_list</A>

1964

<BR>

1965

</BLOCKQUOTE>

1966

1967

<BR>

1968

1969

<A NAME="TOC7" HREF="libmir.html#SEC7">1.4.1 ja_task_update_master_list</A>

1970

<BR>

1971

<A NAME="TOC8" HREF="libmir.html#SEC8">1.4.2 ja_task_update_master_list_usage</A>

1972

<BR>

1973

</BLOCKQUOTE>

1974

1975

<BR>

1976

1977

<A NAME="TOC10" HREF="libmir.html#SEC10">1.5.1 job_update_master_list</A>

1978

<BR>

1979

<A NAME="TOC11" HREF="libmir.html#SEC11">1.5.2 job_update_master_list_usage</A>

1980

<BR>

1981

</BLOCKQUOTE>

1982

1983

<BR>

1984

1985

<A NAME="TOC13" HREF="libmir.html#SEC13">1.6.1 pe_task_update_master_list</A>

1986

<BR>

1987

<A NAME="TOC14" HREF="libmir.html#SEC14">1.6.2 pe_task_update_master_list_usage</A>

1988

<BR>

1989

</BLOCKQUOTE>

1990

<A NAME="TOC15" HREF="libmir.html#SEC15">1.7 queue</A>

1991

<BR>

1992

1993

<A NAME="TOC16" HREF="libmir.html#SEC16">1.7.1 queue_update_master_list</A>

1994

<BR>

1995

</BLOCKQUOTE>

1996

<A NAME="TOC17" HREF="libmir.html#SEC17">1.8 schedd_conf</A>

1997

<BR>

1998

1999

<A NAME="TOC18" HREF="libmir.html#SEC18">1.8.1 schedd_conf_update_master_list</A>

2000

<BR>

2001

</BLOCKQUOTE>

2002

<A NAME="TOC19" HREF="libmir.html#SEC19">1.9 sge_mirror_get_type_descr</A>

2003

<BR>

2004

<A NAME="TOC20" HREF="libmir.html#SEC20">1.10 sge_mirror_get_type_key_nm</A>

2005

<BR>

2006

<A NAME="TOC21" HREF="libmir.html#SEC21">1.11 sge_mirror_get_type_master_list</A>

2007

<BR>

2008

<A NAME="TOC22" HREF="libmir.html#SEC22">1.12 sge_mirror_get_type_name</A>

2009

<BR>

2010

<A NAME="TOC23" HREF="libmir.html#SEC23">1.13 sge_mirror_initialize</A>

2011

<BR>

2012

<A NAME="TOC24" HREF="libmir.html#SEC24">1.14 sge_mirror_process_events</A>

2013

<BR>

2014

<A NAME="TOC25" HREF="libmir.html#SEC25">1.15 sge_mirror_shutdown</A>

2015

<BR>

2016

<A NAME="TOC26" HREF="libmir.html#SEC26">1.16 sge_mirror_strerror</A>

2017

<BR>

2018

<A NAME="TOC27" HREF="libmir.html#SEC27">1.17 sge_mirror_subscribe</A>

2019

<BR>

2020

<A NAME="TOC28" HREF="libmir.html#SEC28">1.18 sge_mirror_unsubscribe</A>

2021

<BR>

2022

<A NAME="TOC29" HREF="libmir.html#SEC29">1.19 sge_mirror_update_master_list</A>

2023

<BR>

2024

<A NAME="TOC30" HREF="libmir.html#SEC30">1.20 sge_mirror_update_master_list_host_key</A>

2025

<BR>

2026

<A NAME="TOC31" HREF="libmir.html#SEC31">1.21 sge_mirror_update_master_list_str_key</A>

2027

<BR>

2028

<A NAME="TOC32" HREF="libmir.html#SEC32">1.22 sharetree</A>

2029

<BR>

2030

2031

<A NAME="TOC33" HREF="libmir.html#SEC33">1.22.1 sharetree_update_master_list</A>

2032

<BR>

2033

</BLOCKQUOTE>

2034

</BLOCKQUOTE>

2035

<A NAME="TOC34" HREF="libmir.html#SEC34">Function Index</A>

2036

<BR>

2037

</BLOCKQUOTE>

2038

2039

2040

2041

2042

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

2043

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

2044

2045

</TR></TABLE>

2046

<H1>Short Table of Contents</H1>

2047

2048

<A NAME="TOC1" HREF="libmir.html#SEC1">1. Eventmirror</A>

2049

<BR>

2050

<A NAME="TOC34" HREF="libmir.html#SEC34">Function Index</A>

2051

<BR>

2052

2053

</BLOCKQUOTE>

2054

2055

2056

2057

2058

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC_Contents">Contents</A>]</TD>

2059

<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="libmir.html#SEC34">Index</A>]</TD>

2060

2061

</TR></TABLE>

2062

<H1>About this document</H1>

2063

This document was generated

2064

using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html

2065

"><I>texi2html</I></A>

2066

<P></P>

2067

The buttons in the navigation panels have the following meaning:

2068

<P></P>

2069

2070

<TR>

2071

<TH> Button </TH>

2072

2073

2074

2075

</TR>

2076

<TR>

2077

2078

[ < ] </TD>

2079

2080

Back

2081

</TD>

2082

<TD>

2083

previous section in reading order

2084

</TD>

2085

<TD>

2086

1.2.2

2087

</TD>

2088

</TR>

2089

<TR>

2090

2091

[ > ] </TD>

2092

2093

Forward

2094

</TD>

2095

<TD>

2096

next section in reading order

2097

</TD>

2098

<TD>

2099

1.2.4

2100

</TD>

2101

</TR>

2102

<TR>

2103

2104

[ << ] </TD>

2105

2106

FastBack

2107

</TD>

2108

<TD>

2109

previous or up-and-previous section

2110

</TD>

2111

<TD>

2112

1.1

2113

</TD>

2114

</TR>

2115

<TR>

2116

2117

[ Up ] </TD>

2118

2119

2120

</TD>

2121

<TD>

2122

up section

2123

</TD>

2124

<TD>

2125

1.2

2126

</TD>

2127

</TR>

2128

<TR>

2129

2130

[ >> ] </TD>

2131

2132

FastForward

2133

</TD>

2134

<TD>

2135

next or up-and-next section

2136

</TD>

2137

<TD>

2138

1.3

2139

</TD>

2140

</TR>

2141

<TR>

2142

2143

[Top] </TD>

2144

2145

Top

2146

</TD>

2147

<TD>

2148

cover (top) of document

2149

</TD>

2150

<TD>

2151

2152

</TD>

2153

</TR>

2154

<TR>

2155

2156

[Contents] </TD>

2157

2158

Contents

2159

</TD>

2160

<TD>

2161

table of contents

2162

</TD>

2163

<TD>

2164

2165

</TD>

2166

</TR>

2167

<TR>

2168

2169

[Index] </TD>

2170

2171

Index

2172

</TD>

2173

<TD>

2174

concept index

2175

</TD>

2176

<TD>

2177

2178

</TD>

2179

</TR>

2180

<TR>

2181

2182

[ ? ] </TD>

2183

2184

About

2185

</TD>

2186

<TD>

2187

this page

2188

</TD>

2189

<TD>

2190

2191

</TD>

2192

</TR>

2193

</TABLE>

2194

<P></P>

2195

where the <STRONG> Example </STRONG> assumes that the current position

2196

is at <STRONG> Subsubsection One-Two-Three </STRONG> of a document of

2197

the following structure:

2198

<UL>

2199

<LI> 1. Section One </LI>

2200

<UL>

2201

<LI>1.1 Subsection One-One</LI>

2202

<UL>

2203

2204

</UL>

2205

<LI>1.2 Subsection One-Two</LI>

2206

<UL>

2207

<LI>1.2.1 Subsubsection One-Two-One

2208

</LI><LI>1.2.2 Subsubsection One-Two-Two

2209

</LI><LI>1.2.3 Subsubsection One-Two-Three     <STRONG>

2210

<== Current Position </STRONG>

2211

</LI><LI>1.2.4 Subsubsection One-Two-Four

2212

</LI></UL>

2213

<LI>1.3 Subsection One-Three</LI>

2214

<UL>

2215

2216

</UL>

2217

<LI>1.4 Subsection One-Four</LI>

2218

</UL>

2219

</UL>

2220

2221

2222

<BR>

2223

2224

This document was generated

2225

by <I>Joachim Gabler</I> on <I>February, 24 2003</I>

2226

using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html

2227

"><I>texi2html</I></A>

2228

</FONT>

2229

2230

</BODY>

2231

</HTML>

Older »