Ricoh InfoPrint Pro C900AFP InfoPrint Manager - Page 75

Activating the user-exit program, ainuxhdr.c, header.c, Makefile, usr/lpp/psf/exits/Makefile, pdset

Page 75 highlights

you must change the source code file name from ainuxhdr.c to header.c. You can also add new exit targets in the Makefile file. 5. You must mark the function as an exported symbol during the link-editing step. See the InfoPrint Manager supplied /usr/lpp/psf/exits/Makefile for more information. Activating the user-exit program Before you can use the new user-exit program, you must activate the program. From an AIX command line, complete these steps: 1. Enter this command: pdls -caux -rall servername:, where servername refers to the name of the server you are using. This command displays the attributes for all current auxiliary sheet objects available on the server. You can also view attributes for a specific auxiliary sheet object. For example, to view attributes for the accounting log, enter this command: pdls -caux -rall servername:accounting-log 2. Use the pdset command to change the values of any of the auxiliary sheet objects, as necessary. To do this task from the InfoPrint Manager Administration Interface, you must select the printer that you want to associate with an auxiliary sheet (in this case, prt1) and then use the Printer -> Properties menu to access the Printer Properties notebook. To complete this task, see the online help topic Using auxiliary-sheet objects in the InfoPrint Manager Administration Interface. Do this procedure from the AIX command line. 1. To create a new auxiliary-sheet object, type: pdcreate -c aux-sh -x psf-exit-prog-name=/usr/lpp/psf/exit_name server1:auxiliary_sheet_name 2. Shut down the actual destination (in this case, prt1). pdshutdown -cp prt1 3. Associate this new auxiliary-sheet object (in this case, an audit exit) with the actual destination. pdset -cp -x dest -x audit-exit=auxiliary_sheet_name prt1 Note: For the post-print accounting exit, instead of this step you will set the attribute in the accounting auxiliary sheet object for the actual destination, using this command: pdset -c auxiliary-sheet -x psf-post-printaccounting-program-name=/usr/lpp/psf/exit_name servername: accounting-log By default, the accounting-log auxiliary sheet object is available for all destinations. This object can point to any combination of the accounting and post-print accounting exits. For example, you can set either one, both, or neither of these attributes at the same time: psf-exit-program-name=name of accounting exit psf-post-print-accounting-program-name=name of post-print accounting exit If you want some printers to have different accounting configurations than others, you must create a new auxiliary sheet object for each configuration. 4. Enable the actual destination (in this case, prt1). pdenable prt1 Chapter 6. User-exit programs (PSF, Generalized Fax, and Email DSS only) 61

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328
  • 329
  • 330
  • 331
  • 332
  • 333
  • 334
  • 335
  • 336
  • 337
  • 338
  • 339
  • 340
  • 341
  • 342
  • 343
  • 344
  • 345
  • 346
  • 347
  • 348
  • 349
  • 350
  • 351
  • 352
  • 353
  • 354
  • 355
  • 356
  • 357
  • 358
  • 359
  • 360
  • 361
  • 362
  • 363
  • 364
  • 365
  • 366
  • 367
  • 368
  • 369
  • 370
  • 371
  • 372
  • 373
  • 374
  • 375
  • 376
  • 377
  • 378
  • 379
  • 380
  • 381
  • 382
  • 383
  • 384
  • 385
  • 386
  • 387
  • 388
  • 389
  • 390
  • 391
  • 392
  • 393
  • 394
  • 395
  • 396
  • 397
  • 398
  • 399
  • 400
  • 401
  • 402
  • 403
  • 404
  • 405
  • 406
  • 407
  • 408
  • 409
  • 410
  • 411
  • 412
  • 413
  • 414
  • 415
  • 416
  • 417
  • 418

you must change the source code file name from
ainuxhdr.c
to
header.c
. You
can also add new exit targets in the
Makefile
file.
5.
You must mark the function as an exported symbol during the link-editing
step. See the InfoPrint Manager supplied
/usr/lpp/psf/exits/Makefile
for more
information.
Activating the user-exit program
Before you can use the new user-exit program, you must activate the program.
From an AIX command line, complete these steps:
1.
Enter this command:
pdls -caux -rall
servername
:
, where
servername
refers to
the name of the server you are using.
This command displays the attributes for all current auxiliary sheet objects
available on the server. You can also view attributes for a specific auxiliary
sheet object. For example, to view attributes for the accounting log, enter this
command:
pdls -caux -rall
servername
:accounting-log
2.
Use the
pdset
command to change the values of any of the auxiliary sheet
objects, as necessary.
To do this task from the InfoPrint Manager Administration Interface, you must
select the printer that you want to associate with an auxiliary sheet (in this case,
prt1
) and then use the
Printer —> Properties
menu to access the
Printer
Properties
notebook. To complete this task, see the online help topic
Using
auxiliary-sheet objects
in the InfoPrint Manager Administration Interface.
Do this procedure from the AIX command line.
1.
To create a new auxiliary-sheet object, type:
pdcreate -c aux-sh -x psf-exit-prog-name=/usr/lpp/psf/
exit_name
server1:
auxiliary_sheet_name
2.
Shut down the actual destination (in this case,
prt1
).
pdshutdown -cp prt1
3.
Associate this new auxiliary-sheet object (in this case, an audit exit) with the
actual destination.
pdset -cp -x dest -x audit-exit=auxiliary_sheet_name prt1
Note:
For the post-print accounting exit, instead of this step you will set the
attribute in the accounting auxiliary sheet object for the actual destination,
using this command:
pdset —c auxiliary-sheet —x psf-post-print-
accounting-program-name=/usr/lpp/psf/
exit_name
servername:
accounting-log
By default, the accounting-log auxiliary sheet object is available for all
destinations. This object can point to any combination of the accounting and
post-print accounting exits. For example, you can set either one, both, or
neither of these attributes at the same time:
psf-exit-program-name=
name of accounting exit
psf-post-print-accounting-program-name=
name of post-print accounting exit
If you want some printers to have different accounting configurations than
others, you must create a new auxiliary sheet object for each configuration.
4.
Enable the actual destination (in this case,
prt1
).
pdenable prt1
Chapter 6. User-exit programs (PSF, Generalized Fax, and Email DSS only)
61